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GroupWise 6.5 Troubleshooting 2: Solutions to Common Problems 


About This Guide 


This Novell® GroupWise® Troubleshooting 2 Guide provides troubleshooting strategies for 
GroupWise problems that can occur with GroupWise clients, Group Wise agents, message 
delivery, and ConsoleOne®. The guide is divided into the following sections: 


+ “General Troubleshooting Strategies” on page 9 
+ “Strategies for Agent Problems” on page 21 
¢ “Strategies for Message Delivery Problems” on page 57 
¢ “Strategies for Administration Problems” on page 79 
¢ “Strategies for Client Problems” on page 89 
+ “Documentation Updates” on page 99 
Other sources of troubleshooting assistance include: 
+ Novell Support Knowledgebase (http://support.novell.com/search/kb_index.jsp) 
+ GroupWise 6.x Support Forums (http://support.novell.com/forums/gw6.html) 


+ GroupWise Cool Solutions (http://www.novell.com/coolsolutions/gwmag/index.html) 


Additional Documentation 


For additional GroupWise documentation, see the following guides at the Novell GroupWise 6.5 
documentation Web site (http://www.novell.com/documentation/lg/gw65): 


¢ Installation Guide 

+ Administration Guide 

+ Multi-System Administration Guide 
¢ Interoperability Guide 

+ GroupWise Client User Guides 


Documentation Updates 


For the most recent version of the GroupWise 6.5 Troubleshooting 2 Guide, visit the Novell 
GroupWise 6.5 documentation Web site (http://www.novell.com/documentation/lg/gw65). 


Documentation Conventions 


In Novell documentation, a greater-than symbol (>) is used to separate actions within a step and 
items in a cross-reference path. 


A trademark symbol (™, z etc.) denotes a Novell trademark. An asterisk denotes a third-party 
trademark. 
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User Comments 


We want to hear your comments and suggestions about this manual and the other documentation 
included with GroupWise. Please use the User Comment feature at the bottom of each page of the 


GroupWise online documentation. 
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General Troubleshooting Strategies 


This part of Troubleshooting 2: Solutions to Common Problems helps you resolve GroupWise® 
problems that are not related to specific error messages or components of your system. It can also 
help with problems that have not been resolved by more specific troubleshooting strategies. 


+ “General GroupWise Troubleshooting Strategies” on page 11 

+ “General Hardware/Network Troubleshooting Strategies” on page 15 

+ “Useful Linux Commands for Administering a GroupWise System” on page 17 
Other sources of assistance include: 

+ Novell Support (http://support.novell.com) 

+ Novell® Support Knowledgebase (http://support.novell.com/search/kb_index.jsp) 

+ GroupWise 6.x Support Forums (http://support.novell.com/forums/2gw.html) 


+ GroupWise Cool Solutions (http://www.novell.com/coolsolutions/gwmag/index.html) 
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General GroupWise Troubleshooting Strategies 


+ “Checking GroupWise Agent Log Files” on page 11 

+ “Assigning a GroupWise Administrator” on page 11 

+ “Checking IP Addresses and Port Numbers for TCP/IP Links” on page 11 

+ “Recovering and Rebuilding Domain and Post Office Databases” on page 12 
+ “Analyzing and Fixing User and Message Databases” on page 12 

+ “Verifying GroupWise System Information” on page 12 


+ “Understanding Message Flow” on page 13 


Checking GroupWise Agent Log Files 
Problem: You are experiencing message delivery problems. 


Action: Use the POA and MTA log files to help you track message delivery problems. Set the logging level 
to Verbose so all processing information is displayed. This information can help you determine 
what the problem is. You should also verify that the information is being logged to disk. See the 
following sections in the GroupWise 6.5 Administration Guide. 


+ “Using POA Log Files” in “Post Office Agent” 

+ “Using MTA Log Files” in “Message Transfer Agent” 

+ “Using Internet Agent Log Files” in “Internet Agent” 

+ “Controlling WebAccess Agent Logging” in “WebAccess” 
+ “Configuring Monitor Agent Log Settings” in “Monitor” 


Assigning a GroupWise Administrator 
Problem: No one is receiving error messages generated by the MTA and the POA. 


Action: | Make sure each domain has an administrator who receives error messages generated by the agents. 
See “Notifying the Domain Administrator” in “Message Transfer Agent” in the GroupWise 6.5 
Administration Guide. 


Checking IP Addresses and Port Numbers for TCP/IP Links 


Problem: Incorrect IP addresses and port numbers can cause problems for the Group Wise® client and agents 
when TCP/IP connections are used. 


Possible Cause: The GroupWise client is set up with the wrong IP address and/or TCP port number. 


Action: Make sure the Group Wise client is set up with the correct IP address and port number for the POA 
in each user's post office. See “Client” in the GroupWise 6.5 Administration Guide. 
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Action: 


Possible Cause: 


Action: 


Possible Cause: 


Action: 


Possible Cause: 


Action: 


Make sure the GroupWise name server is running so that IP addresses and port numbers can be 
looked up automatically. See the “Simplifying Client/Server Access with a GroupWise Name 
Server” in “Post Office Agent” in the GroupWise 6.5 Administration Guide. 


The POA is set up with the wrong IP address and/or TCP port number. 


Make sure the POA is set up with the correct IP address and port number. See “Using Client/ 
Server Access to the Post Office” in “Post Office Agent” in the GroupWise 6.5 Administration 
Guide. 


The MTA is set up with the wrong IP address and/or TCP port number. 


Make sure the MTA is set up with the correct IP address and port number. See “Using TCP/IP 
Links between Domains” and “Using TCP/IP Links between a Domain and its Post Offices” in 
“Message Transfer Agent” in the GroupWise 6.5 Administration Guide. 


Multiple programs on the same server are set up with the same TCP port number. 


Make sure no duplicate port numbers are in use. 


Recovering and Rebuilding Domain and Post Office Databases 


Problem: 


Action: 


Problems with a domain database (wpdomain.db) or post office database (wphost.db) can cause 
access problems for GroupWise Administrator and the Group Wise client, as well as cause message 
delivery problems. Database problems can also cause information in your system to be out of sync 
(for example, a user's information in one post office being different than that user's information in 
another post office). 


See “Maintaining Domain and Post Office Databases” in “Databases” in the GroupWise 6.5 
Administration Guide. 


Analyzing and Fixing User and Message Databases 


Problem: 


Action: 


Problems with a user database (userxxx.db) or a message database (msgvn.db) can cause users to 
lose access to their mailboxes, have incorrectly displayed mailbox information, and have message 
delivery problems. 


See “Maintaining User/Resource and Message Databases” in “Databases” and “Group Wise Check 
(GWCheck)” in “Standalone Database Maintenance Programs” in the GroupWise 6.5 
Administration Guide. 


Verifying GroupWise System Information 


Problem: 


Possible Cause: 


Action: 


Action: 


Possible Cause: 


Action: 


Messages are not being delivered to post offices or domains, or you are receiving excessive 
undeliverable messages. 


Link configuration problems with your Group Wise system can cause message delivery problems. 


Check links between domains. See “Understanding Link Configuration” in “Domains” in the 
GroupWise 6.5 Administration Guide. 


Check links to post offices. See “Understanding Link Configuration” in “Domains” in the 
GroupWise 6.5 Administration Guide. 


Incorrect object information can cause message delivery problems. 


Check Domain and Post Office object properties. See the following sections in the GroupWise 6.5 
Administration Guide: 


¢ “Editing Domain Properties” in “Domains” 


¢ “Editing Post Office Properties” in “Post Offices” 
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Action: Check Agent object properties. See the following sections in the GroupWise 6.5 Administration 
Guide. 


+ “Configuring the POA in ConsoleOne” in “Post Office Agent” 
+ “Configuring the MTA in ConsoleOne” in “Message Transfer Agent” 
+ “Configuring Internet Agent Services” in “Internet Agent” 
+ “Configuring WebAccess Components” in “WebAccess” 
+ “Configuring the Monitor Agent” in “Monitor” 
Possible Cause: Correct information is not being synchronized throughout your GroupWise system. 


Action: — If information is correct in some places but incorrect in others, you can synchronize GroupWise 
information. See “Synchronizing Database Information” in “Databases” in the GroupWise 6.5 
Administration Guide. 


Understanding Message Flow 
Problem: You are experiencing message delivery problems. 


Action: | Because each component (Group Wise client, POA and MTA) is responsible for a specific area of 
message flow, knowing where the message flow has been interrupted can help you discover which 
component is not functioning correctly. See “Message Flow Diagrams” in GroupWise 6.5 
Troubleshooting 3: Message Flow and Directory Structure. 
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General Hardware/Network Troubleshooting Strategies 


+ “Checking Available System Resources” on page 15 


è “Checking Available Disk Space” on page 15 


Checking Available System Resources 
Problem: The GroupWise® agents cannot perform well when inadequate system resources are available. 


Action: Make sure the servers where agents run meet basic system requirements. See “GroupWise System 
Requirements” in “Installing a Basic GroupWise System” in the GroupWise 6.5 Installation 
Guide. 


Checking Available Disk Space 


Problem: When one of the GroupWise programs tries to create or modify a file and there is not enough disk 
space available to complete the task, you will generally get a disk full error message. 


Action: Free up space on the disk. 
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Useful Linux Commands for Administering a GroupWise 


System 


Some GroupWise administrators might be new to the Linux operating system that is supported as 
of GroupWise 6.5 for Linux and GroupWise 6.5 Support Pack 3. This section lists Linux 
commands that can help you manage your GroupWise system on Linux. 


+ “Basic Commands” on page 17 


+ “File and Directory Commands” on page 17 


+ “Process Commands” on page 18 


+ “Disk Usage Commands” on page 19 


+ “Package Commands” on page 19 


+ “File System Commands” on page 19 


+ “Network Commands” on page 20 


Basic Commands 
Command 


man command 


whoami 
uname -a 


eject 


File and Directory Commands 


Command 
pwd 


Is -I 


Is -al 


more filename 


less filename 


Description 


Displays information about any Linux command, including the commands used 
to start GroupWise programs. 


Displays who you are logged in as. 
Displays the kernel version, along with other useful information 


Ejects the CD from the drive. 


Description 
Displays your current directory (“print working directory”). 


Lists the files in the current directory, along with useful 
information about them. 


Includes hidden system files (those whose names start 
with a dot) in the list. 


Pages through the contents of a file (forward only). 


Pages through the contents of a file and lets you page 
back up through the file. 
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Command 


tail filename 


cp source destination 


mv source destination 


Description 


Displays the last 10 lines of a file. This is helpful for log 
files. (The head commands displays the first 10 lines.) 


Copies a file or directory. 


Moves or renames a file or directory. 


find starting_directory -name filename Find the specified file, starting in the specified directory. 


grep string file 


mkdir directory_name 
rmdir directory_name 
rm filename 

rm -r directory_name 


cat filename 


cat filename /printer_device 


Process Commands 
Command 


top 


ps -eaf | grep program 


ps -aux | grep username 
kill process_/D 


kill -9 process_/D 


killall program 


xkill 


Specifying / would start the find operation in the root 
directory. 


Searches the specified file for the specific string of 
characters. This is useful for locating specific information 
in GroupWise agent startup files. 

Creates a new directory 

Deletes an empty directory 

Deletes a file 

Deletes a directory and recursively deletes its contents. 
Displays a file. 


Prints a file. 


Description 


Lists all processes, sorted by CPU percentage with the highest at the top 
of the list. 


Lists all processes and their IDs associated with the specified program. 
Wildcard characters can be used to list a group of related programs (for 
example, gw*). 

Lists all processes and their IDs associated with the specified user. 


Stops the specified process like a normal exit. 


Stops the specified process after it has failed to exit normally. Temporary 
files are not cleaned up. 


Kills all processes associated with the specified program. 


Closes the window that you click on with the resulting box-shaped cursor. 
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Disk Usage Commands 


Command 


df 


du -s 


du -s file_or_directory 


Package Commands 


Command 
rpm -qa | grep novell 


rpm -qi package_name 


rpm -ql package_name 
rpm -e package_name 
File System Commands 


Command 


mount 


mount -t ncpfs //NetWare_server_DNS_name 
/mountpoint_directory 


-O user=username 


Description 


Lists file system disk space usage in terms that make sense to your 
computer. 


Lists file system disk space usage in terms that make sense to humans. 


Lists disk space usage of each subdirectory below your current working 
directory 


Lists the cumulative disk space usage of your current working directory. 


Lists the disk space usage for a file or the cumulative disk space usage for 
a directory and its contents. 


Description 
Lists all Novell packages installed on your server 


Lists useful information about an installed package, such as name, 
version, release date, install date, size description, build date, and so on. 


Lists where each file in the package has been installed 


Uninstalls a package 


Description 


Lists the file systems that are currently mounted 
on your server. 


Mounts a NetWare server as a file system on your 
Linux server. 


-o ipserver=server_IP_address 
-o server=server_hostname 


mount -t smbfs //Windows_server_name/share 
/mountpoint_directory 


Mounts a Windows server as a file system on your 
Linux server. 


-O username=username 
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Network Commands 
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Command 


ifconfig -a 


hostname 


dig 


netstat -Inp | grep program 
netstat -Inp | egrep ‘program|progran)|...’ 


ping /P_address_or_hostname 


Description 


Lists the IP address and other detailed information about 
the NIC in your Linux server. 


Displays the hostname of your server. 

Displays host information about your server 

Lists the port numbers in use by one or more programs. It 
is also a handy command for checking to see whether the 


specified programs are currently running. 


Checks to see if the specified server is responding on the 
network. 
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Strategies for Agent Problems 


This part of Troubleshooting 2: Solutions to Common Problems helps you resolve problems with 
individual agents, the Post Office Agent (POA) or the Message Transfer Agent (MTA), the 
Internet Agent, the WebAccess Agent, or the Monitor Agent. 


+ 


+ 


+ 


+ 


+ 


“Post Office Agent Problems” on page 23 
“Message Transfer Agent Problems” on page 31 
“Internet Agent Problems” on page 37 
“WebAccess Agent Problems” on page 51 
“Monitor Agent Problems” on page 55 


Other sources of assistance include: 


+ 


+ 


+ 


+ 


Novell Support (http://support.novell.com) 
Novell® Support Knowledgebase (http://support.novell.com/search/kb_index.jsp) 
Group Wise 6.x Support Forums (http://support.novell.com/forums/2gw.html) 


Group Wise Cool Solutions (http://www.novell.com/coolsolutions/gwmag/index.html) 
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Post Office Agent Problems 


POA Won't Start 


Problem: 


Possible Cause: 


Action: 


Possible Cause: 


Action: 


+ “Post Office Agent Error Messages” in GroupWise 6.5 Troubleshooting 1: Error Messages 
+ “POA Won't Start” on page 23 

+ “POA Shuts Down Unexpectedly” on page 25 

+ “POA Statistics Box Shows Requests Pending” on page 26 

+ “POA Statistics Box Shows Users Timed Out” on page 26 

+ “POA Statistics Box Shows Undeliverable Users” on page 26 

+ “POA Statistics Box Shows Problem Messages” on page 26 

+ “POA Redirection List Shows Failed TCP/IP Connection” on page 27 

+ “POA Message Transfer Status Box Shows Closed Link” on page 27 

+ “POA Starts Unwanted TCP/IP Thread” on page 27 

+ “POA Fails to Deliver Messages” on page 28 

+ “POA Fails to Respond to MTP Configuration Changes in ConsoleOne” on page 28 

+ “POA Fails to Respond to Other Configuration Changes in ConsoleOne” on page 28 

+ “POA Fails to Update the Post Office Database Version” on page 28 

+ “POA Runs Repeated Recoveries on the Same Database” on page 29 

+ “POA Starts in the Wrong Language” on page 29 

+ “POA Is Involved with Network Operating System or Hardware Problems” on page 29 


The POA does not start. 
The /home switch is missing. 


Make sure the /home startup switch provides the correct path to the post office directory where the 
post office database (wphost.db) resides. This switch is required to start the POA and must be 
provided either in the POA startup file or on the command line when you start the POA. See 
“Installing and Starting the POA” in “Post Office Agent” in the GroupWise 6.5 Administration 
Guide. 


The /home switch points to an unavailable location. 


Make sure the location specified by the /home startup switch is currently available to the POA. If 
the post office is located on a different server from where the POA will run, preparations for the 
connection between the POA and the post office are required: 


¢ Ifyou are using the NetWare® POA, you must use the /dn startup switch or the /user and / 
password startup switches to enable the POA to log in to the server where the post office is 
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Possible Cause: 
Action: 
Possible Cause: 


Action: 


Possible Cause: 


Action: 


Possible Cause: 


Action: 


Possible Cause: 


Action: 


Possible Cause: 
Action: 
Action: 
Action: 


Action: 


Possible Cause: 


Action: 


Possible Cause: 


located, or you can provide the username and password in ConsoleOne, on the Post Office 
Settings page of the Post Office object. 


¢ Ifyou are using the Linux POA, you must mount the file system where the post office is 
located to the server where the POA is running. 


+ Ifyou are using the Windows POA, you must create the drive mapping to the post office 
before starting the POA. 


See “Installing and Starting the POA” in “Post Office Agent” in the GroupWise 6.5 Administration 
Guide. 


The server where the post office resides is down. 
Check the status of the server where the post office resides. 
The POA does not have sufficient rights to the post office directory. 


Make sure the network rights in the post office are correct. Start the POA using the /rights switch 
to determine the specific problem the POA is encountering and make corrections as needed. 


The post office database (wphost.db) is damaged. 


If the post office database is available to the POA but cannot be read, it might be damaged. In 
ConsoleOne®, perform database maintenance to correct any problems with the post office 
database. See “Maintaining Domain and Post Office Databases” in “Databases” in the Group Wise 
6.5 Administration Guide. 


The POA server has inadequate resources. 


Make sure the server where you are trying to run the POA has adequate resources to run the POA, 
especially adequate available memory and the current versions of any required network system 
files. See “Agent System Requirements” in “Installing GroupWise Agents” in the Group Wise 6.5 
Installation Guide. 


Use your operating system tools to check current server resources. 
The POA is not installed correctly. 


Make sure all files required to run the POA are installed. For a list of agent files, see “Agent 
Installation Directories” in GroupWise 6.5 Troubleshooting 3: Message Flow and Directory 
Structure. 


A remote document storage area is unavailable. 

Make sure the remote server where the document storage area is located is running. 

Make sure the POA has sufficient rights to log in. 

Make sure the /user and /password or /dn switches have been provided in the POA startup file. 


As a temporary workaround, you can start the POA with the /noconfig switch, so it can start 
without trying to access the remote document storage area. 


Language files are missing. 


If you are using the /language startup switch to run the POA in a particular language, the 
corresponding language files must be installed for the POA to run in that language. To determine 
what language-specific files are required, see “Agent Installation Directories” in GroupWise 6.5 
Troubleshooting 3: Message Flow and Directory Structure. 


A POA is already running on the server. 
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Action: 


Possible Cause: 


Action: 


If you have defined multiple POAs for the same post office in ConsoleOne, the /name switch is 
required in each startup file to specify which POA configuration to use when you start each 
instance of the POA. 


The POA encounters an error condition. 


If you receive an error message when trying to start the POA, look it up in “Post Office Agent Error 
Messages” in GroupWise 6.5 Troubleshooting 1: Error Messages. 


POA Shuts Down Unexpectedly 


Problem: 


Action: 


Action: 


Action: 


Possible Cause: 


Action: 


Action: 


Possible Cause: 


Action: 


Possible Cause: 


Action: 


Possible Cause: 


The POA has been running smoothly, but stops unexpectedly. 


If the POA agent console is still displayed, exit it. If the normal exit procedure does not work, use 
the system procedure for terminating a program. 


+ Ifyou are using the NetWare POA on NetWare, use the NetWare unload command. If you 
have other POAs running on the same server, you should exit them before using the unload 
command. The unload command unloads all POAs running on the same server and might not 
enable them to terminate gracefully. 


+ If you are using the Linux POA, kill the first POA process. You might need to use kill -9. 
+ If you are using the Windows POA, close the POA window. 


After the POA agent console is no longer displayed, restart the POA as you normally would. See 
“Installing and Starting the POA” in “Post Office Agent” in the GroupWise 6.5 Administration 
Guide. If the POA shuts down again, exit it again, reboot the server, then start it again. 


Set the POA log level to Verbose for troubleshooting. See “Using POA Log Files” in “Post Office 
Agent” in the GroupWise 6.5 Administration Guide. 


Occasionally, a badly damaged message file can cause the POA to shut down. 


Check the contents of the POA input queue in the post office. For the location of the POA input 
queue in the post office, see “Post Office Directory” in Group Wise 6.5 Troubleshooting 3: Message 
Flow and Directory Structure. 


Move the message files out of the input queue subdirectories, start the POA, then copy the message 
files back in groups, watching the POA carefully to see if it shuts down on a particular message 
file. If it does, delete the problem message file so normal processing can resume. 


Rename the post_office\wpcsout\ofs directory, then start the POA. This creates a new, empty input 
queue and the POA should run smoothly. Then copy the message files from the 0-7 priority 
subdirectories of wpcsout\ofs back into the correct priority subdirectory so the POA can process 
them. Copy them in small groups so the damaged message file can be identified and removed. 


Occasionally, a damaged database in the post office can cause the POA to shut down. 


In ConsoleOne, perform maintenance to correct any problems with the databases in the post office. 
See “Maintaining Domain and Post Office Databases” and “Maintaining User/Resource and 
Message Databases” in “Databases” in the GroupWise 6.5 Administration Guide. 


Although increasing the number of POA threads from their default settings can, in many cases, 
improve POA performance, creating too many POA threads can have undesirable results. 


For guidance is setting an appropriate number of POA threads, see “Optimizing the POA” in “Post 
Office Agent” in the GroupWise 6.5 Administration Guide. 


On a NetWare server, Upgrade Low Priority Threads is set to On. 
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Action: 


Possible Cause: 


Action: 


The POA might run more smoothly if you set Upgrade Low Priority Threads to Off. At the server 
console where the POA is running, type set upgrade low priority threads=off. 


Another program on the server is interfering with the operation of the POA. 


If the POA continues to be unstable, eliminate other programs running on the server. If the POA 
is stable when another specific program is not running on the same server with it, a conflict might 
exist between the two programs. 


POA Statistics Box Shows Requests Pending 


Problem: 


Action: 


Group Wise client users are using TCP/IP links to the post office. At the POA console, the Statistics 
box shows a large number of pending client/server requests. 


Increase the number of POA connections so that more users can be serviced by the POA. See 
“Adjusting the Number of Connections for Client/Server Processing” in “Post Office Agent” in 
the GroupWise 6.5 Administration Guide. 


POA Statistics Box Shows Users Timed Out 


Problem: 


Action: 


Group Wise client users are using TCP/IP links to the post office. At the POA console, the Statistics 
box shows a large number of users timed out. 


Having users timed out does not indicate a problem with the POA, but rather a problem with users. 
Users who have timed out are users for which the POA has closed the connection because the 
Group Wise client was no longer communicating. Timed out users might not be exiting Group Wise 
normally or might be having other problems with their workstations. The number of timed-out 
users might tend to increase on a daily basis during the hour after users leave to go home. This is 
not a problem. 


POA Statistics Box Shows Undeliverable Users 


Problem: 


Possible Cause: 


Action: 


Action: 


At the POA console, the Statistics box shows a large number of undeliverable users. Undeliverable 
users can be encountered using either mapped drive connections or TCP/IP connections. 
Undeliverable users are counted differently from undeliverable messages. For example, a single 
message could be addressed to 10 users; perhaps 9 users received the message successfully but 1 
user was undeliverable. 


If messages cannot be delivered to a particular user, that user might have a damaged user database 
(userxxx.db). 


In ConsoleOne, perform maintenance to correct any problems with the user database so messages 
can be delivered. See “Maintaining User/Resource and Message Databases” in “Databases” in the 
GroupWise 6.5 Administration Guide. 


Check the POA log file for other reasons why messages cannot be delivered to specific users. See 
“Using POA Log Files” in “Post Office Agent” in the GroupWise 6.5 Administration Guide. 


POA Statistics Box Shows Problem Messages 


Problem: 


Action: 


At the POA console, the Statistics box shows that problem messages have been encountered. 


The problem messages number indicates how many messages could not be processed by the POA. 
For strategies, see “Message Is Dropped in the problem Directory in the Post Office” on page 77. 
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POA Redirection List Shows Failed TCP/IP Connection 


Problem: 


Action: 


Action: 


Action: 


Possible Cause: 


Action: 


Possible Cause: 


Action: 


At the POA console, client/server statistics show a failed TCP/IP connection. 


Under Client/Server Statistics, use Show Redirection List to list existing POAs and the IP 
addresses of the computers they are running on. 


Under Client/Server Statistics, use Check Redirection List to determine which connections are 
currently valid. 


If a connection is listed as failed for a POA, use the ping command to see if the server is alive. If 
the server does not respond to the PING command, you must resolve the TCP/IP problem before 
the POA can use the link successfully. 


TCP/IP is not functioning correctly on the POA server. 


If the POA is running on a Windows* server, make sure TCP/IP is correctly installed and set up 
on the server where the POA is running. 


Multiple servers are trying to use the same IP address. 


Check for conflicting IP addresses between those used by POA servers and those used by other 
servers. Only one server at a time can use the same IP address. 


POA Message Transfer Status Box Shows Closed Link 


Problem: 


Action: 


Action: 


The POA is configured to communicate with the MTA by way of TCP/IP. However, the link 
between the POA and the MTA displays as Closed. 


Check the last closure reason. This information can help you determine the source of the problem. 
Common last closure reasons include: 


Host refused connection 

No peer listening for connection (B30A) 
Port already in use (B309) 

TCP/IP connection failure (8908) 
TCP/IP disconnected (890F) 

TCP/IP read timeout (8912) 


See also “POA Fails to Respond to MTP Configuration Changes in ConsoleOne” on page 28. 


POA Starts Unwanted TCP/IP Thread 


Problem: 


Explanation: 


Action: 


Even though you have started the POA using the /notcpip startup switch or disabled the Enable 
TCP/IP option in the POA Agent Settings page in ConsoleOne, the POA still starts a TCP/IP 
thread. 


When you select Client/Server Only or Client/Server and Direct as the access mode for a post 
office and use the /notcpip switch when starting a POA, that POA does not accept incoming client/ 
server connections from GroupWise clients. However, it still starts a single TCP/IP handler thread 
if TCP/IP is configured on the server. The purpose of this TCP/IP thread is to notify any 

Group Wise clients connecting to another POA in the post office via TCP/IP they should reread the 
database because a new message has been delivered by a POA that is not using TCP/IP. 


To totally disable TCP/IP processing in a post office, set the access mode for the post office to 
Direct Only and start all POAs servicing that post office with the /notcpip switch, or deselect 
Enable TCP/IP in the Agent Settings page in ConsoleOne. 
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POA Fails to Deliver Messages 


Problem: 
Possible Cause: 


Action: 


Possible Cause: 


Action: 


The POA is running but no messages are being delivered. 
The post office is closed. 


From the MTA console, check the status of the post office from the point of view of the domain. 
See “Displaying MTA Status Information” in “Monitoring the MTA” in the GroupWise 6.5 
Administration Guide. If the post office is closed, messages are not arriving in the post office. 
Correct the problem with the MTA. See “MTA Status Box Shows a Closed Location” on page 33. 


Message file processing has been turned off. 


Make sure that message file processing for the POA has not been turned off using the /nomf, / 
nomfhigh, or /nomflow switches. 


POA Fails to Respond to MTP Configuration Changes in ConsoleOne 


Problem: 


Action: 


Action: 


Action: 


You change a POA link configuration or network address setting in ConsoleOne, but the POA does 
not respond to the change. For example, you change from a mapped or UNC link to a TCP/IP link 
between the POA and the MTA, or you move the POA to a different server and change its IP 
address. If the configuration change does not replicate successfully to the post office database, the 
MTA link to the post office becomes closed. 


If you do not want to stop and restart the POA to open a closed post office link, change the 
configuration information back to what it was before you tried to change it. The MTA should then 
be able to open the post office link again. After communication between the POA and MTA is re- 
established, make the configuration changes again. Wait for the configuration changes to be 
replicated to the post office database (wphost.db), then start the POA in its new location. 


Stop the POA, then start the POA using the /mtpinipaddr and /mtpinport switches to specify the 
new IP address and port the POA should use for Message Transfer Protocol (MTP) communication 
with the MTA. After the link is established and all administrative messages have been processed, 
you do not need to use these startup switches again. 


Stop the POA. Rebuild the post office database (wphost.db) to replicate the configuration changes. 
See “Rebuilding Domain or Post Office Databases” in “Databases” in the GroupWise 6.5 
Administration Guide. 


POA Fails to Respond to Other Configuration Changes in ConsoleOne 


Problem: 


Action: 


Action: 


You change a POA configuration setting in ConsoleOne, but the POA does not respond to the 
change. For example, you change from direct access to client/server mode, or you want to turn off 
error mail to the administrator. 


Synchronize the post office database (wphost.db) with the domain database (wpdomain.db). See 
“Synchronizing Database Information” in “Databases” in the GroupWise 6.5 Administration 
Guide. 


Stop the POA. Rebuild the post office database (wphost.db) to replicate the configuration changes. 
See “Rebuilding Domain or Post Office Databases” in “Databases” in the GroupWise 6.5 
Administration Guide. 


POA Fails to Update the Post Office Database Version 


Problem: 


You are updating the agent software on a server where both the POA and the MTA are running. 
The MTA successfully updates the database version for the domain but the POA fails to update 
the database version for the post office. 
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Possible Cause: 


Action: 


Action: 


You let the Installation program start both agents automatically. As a result, the POA checked the 
domain version in the post office database before it had a chance to process the administrative 
message from the MTA that would update the domain version in the post office database. 


Wait until the MTA has updated the domain database. For a large domain database, you might 
need to wait as much as 20 minutes or more. Verify that the database version has been updated by 
checking the Domain object’s Identification page in ConsoleOne, then stop and restart the POA to 
update the post office database. Check the Post Office object’s Identification page in ConsoleOne 
to verify that the database version has been updated. 


If restarting the POA does not update the post office database version: 


1 Compare the dates on the .dc files (gwpo.dc and ngwguard.dc) in the post office directory with 
the dates on the .dc files in the update source (the GroupWise 6.5 Administrator CD or the 
software distribution directory if it has been updated from the GroupWise 6.5 Administrator 
CD). 


2 Ifthe dates on the .dc files in the post office are older than the dates on the .dc files in the 
update source, copy the .dc files from the update source into the post office directory. 


3 At the POA console, recover the post office database. See “Recovering the Post Office 
Database Automatically or Immediately” in “Post Office Agent” in the GroupWise 6.5 
Administration Guide. 


When the recovery process is finished, the database version should be updated. 


4 View the Post Office object’s Identification page in ConsoleOne to verify that the database 
version has been updated. 


POA Runs Repeated Recoveries on the Same Database 


Problem: 


Action: 


Action: 


The POA continually attempts to recover a particular database but never succeeds. 


The recovery operation that the POA can perform while the database is in use is not as powerful 
as a rebuild operation. Rebuild the problem database. See “Maintaining Domain and Post Office 
Databases” and “Maintaining User/Resource and Message Databases” in “Databases” in the 
GroupWise 6.5 Administration Guide. 


If the problem is occurring with a user database and it cannot be rebuilt, re-create the user database. 
See “Re-creating a User Database” in “Databases” in the GroupWise 6.5 Administration Guide. 


POA Starts in the Wrong Language 


Problem: 


Action: 


You have installed the POA in more than one language and it is starting in a different language 
than you want. 


Start the POA using the /language switch to specify the language. 


POA Is Involved with Network Operating System or Hardware Problems 


Problem: 


Possible Cause: 


Action: 


The POA is interacting with the network operating system or hardware in an undesirable way. 


If you just updated the NetWare® POA software, you might not have unloaded the agent engine 
(gwenn4.nlm), resulting in a series of "Loader cannot find public symbol: symbol" errors on the 
server console. 


Unload gwenn4.nlm, then start the NetWare POA, so that the newly installed agent engine is 
loaded along with it. 


Post Office Agent Problems 29 


30 


Possible Cause: 


Action: 
Possible Cause: 


Action: 


Possible Cause: 


Action: 


The NetWare POA server is running older software, resulting in TCP_HANDLER errors on the 
server console. 


Make sure you are using the most current TCP/IP stack for NetWare. 
The POA server is overburdened, resulting in SYN attacks. 


Make sure overall server utilization is not too high. Increase the POA's TCP/IP resources. See 
“Adjusting the Number of Connections for Client/Server Processing” in “Post Office Agent” in 
the GroupWise 6.5 Administration Guide. 


The POA server is overburdened. CPU utilization on the server where the NetWare POA is 
running jumps to 100% and the POA seems to be taking all available resources. Group Wise and 
other objects on the server are out of sync with other servers. 


Run DSREPAIR. 
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Message Transfer Agent Problems 


+ “Message Transfer Agent Error Messages” in GroupWise 6.5 Troubleshooting 1: Error 
Messages 


+ “MTA Won't Start” on page 31 

+ “MTA Shuts Down Unexpectedly” on page 32 

+ “MTA Status Box Shows a Closed Location” on page 33 

+ “MTA Statistics Box Shows Undeliverable Messages” on page 34 
+ “MTA Statistics Box Shows Errors” on page 34 

+ “MTA Configuration Status Isn't Open” on page 35 

+ “MTA Fails to Update the Domain Database Version” on page 35 
e “MTA Starts in the Wrong Language” on page 36 


+ “MTA Is Involved with Network Operating System or Hardware Problems” on page 36 


MTA Won't Start 
Problem: The MTA does not start. 
Possible Cause: The /home switch is missing. 


Action: | Make sure the /home startup switch provides the correct path to the domain directory where the 
domain database (wpdomain.db) resides. This switch is required to start the MTA and must be 
provided either in the MTA startup file or on the command line when you start the MTA. See 
“Installing and Starting the MTA” in “Message Transfer Agent” in the GroupWise 6.5 
Administration Guide. 


Possible Cause: The /home switch points to an unavailable location. 


Action: Make sure the location specified by the /home startup switch is currently available to the MTA. If 
the domain is located on a different server from where the MTA will run, preparations for the 
connection between the MTA and the domain are required: 


+ If you are using the NetWare® MTA, you must use the /dn startup switch or the /user and / 
password startup switches to enable the MTA to log in to the server where the domain is 
located. 


+ If you are using the Linux MTA, mount the file system where the domain is located to the 
server where the MTA is running. 


¢ If you are using the Windows MTA, you must create the drive mapping to the domain and 
post offices in the domain before starting the MTA. 


Possible Cause: The server where the domain resides is down. 


Action: | Check the status of the server where the domain resides. 
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Possible Cause: 


Action: 
Possible Cause: 
Action: 
Possible Cause: 


Action: 


Possible Cause: 


Action: 


Possible Cause: 


Action: 


Possible Cause: 


Action: 


Possible Cause: 


Action: 


Possible Cause: 


Action: 


The /work switch points to an unavailable location. Although not required, the /work startup 
switch is useful to specify a local working directory for the MTA when the domain it services is 
located on a different server. Using the /work switch to provide a local working directory on the 
server where it is installed is highly recommended for MTA performance. If the /work switch is 
not used, the working directory is placed in the directory specified by the /home switch. 


Make sure the location of the MTA working directory is available to the MTA. 
The MTA does not have sufficient rights to the domain directory. 

Make sure the network rights in the domain are correct. 

The domain database (wpdomain.db) is damaged. 


If the domain database (wpdomain.db) is available to the MTA but cannot be read, it might be 
damaged. In ConsoleOne®, perform maintenance to correct any problems with the domain 
database. See “Maintaining Domain and Post Office Databases” in “Databases” in the Group Wise 
6.5 Administration Guide. 


The MTA server has inadequate resources. 


Make sure the server where you are trying to run the MTA has adequate resources to run the MTA, 
especially adequate available memory and the current versions of any required network system 
files. See “Agent System Requirements” in “Installing GroupWise Agents” in the GroupWise 6.5 
Installation Guide. 


The MTA is not installed correctly. 


Make sure all files required to run the MTA are installed. For a complete list, see “Agent 
Installation Directories” in GroupWise 6.5 Troubleshooting 3: Message Flow and Directory 
Structure. 


Language-specific files are missing. 


If you are using the /language startup switch to run the MTA in a particular language, the 
corresponding language files must be installed for the MTA to run in that language. To determine 
what language-specific files are required, see “Agent Installation Directories” in GroupWise 6.5 
Troubleshooting 3: Message Flow and Directory Structure. 


The MTA is encountering a problem with one specific aspect of its functioning. 


MTA startup switches are available to disable specific MTA functions while allowing other 
functions to continue normally. For example, the /noada switch disables the MTA admin thread. 
If a specific MTA function is causing the MTA to shut down, you might be able to disable that 
particular function with a startup switch. See “Using MTA Startup Switches” in “Message Transfer 
Agent” in the GroupWise 6.5 Administration Guide. 


The MTA encounters an error condition. 


If you receive an error message when trying to start the MTA, look it up in “Message Transfer 
Agent Error Messages” in GroupWise 6.5 Troubleshooting 1: Error Messages. 


MTA Shuts Down Unexpectedly 
Problem: The MTA has been running smoothly, but stops unexpectedly. 


If the MTA agent console is still displayed, exit it. If the normal exit procedure does not work, use 
the system procedure for terminating a program. 


Action: 


+ If you are using the NetWare MTA, use the NetWare unload command. If you have other 
MTAs running on the same server, you should exit them before using the unload command. 
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Action: 


Action: 


Action: 


Possible Cause: 


Action: 


Possible Cause: 


Action: 


Possible Cause: 


Action: 


Possible Cause: 


Action: 


Possible Cause: 


Action: 


The unload command unloads all MTAs running on the same server and might not enable 
them to terminate gracefully. 


¢ Ifyou are using the Linux MTA, kill the first MTA process. You might need to use kill -9. 
+ If you are using the Windows MTA, close the MTA window. 


After the MTA agent console is no longer displayed, restart the MTA as you normally would. See 
“Installing and Starting the MTA” in “Message Transfer Agent” in the GroupWise 6.5 
Administration Guide. 


If the MTA shuts down again, exit it again, reboot the server, then start the MTA again. 


Set the MTA log level to Verbose for troubleshooting. See “Using MTA Log Files” in “Message 
Transfer Agent” in the GroupWise 6.5 Administration Guide. 


Occasionally, a badly damaged message file can cause the MTA to shut down. 


Check the contents of the MTA input queues in the domain and post offices. For the locations of 
the MTA input queues, see “Message Transfer/Storage Directories” in GroupWise 6.5 
Troubleshooting 3: Message Flow and Directory Structure. 


Move the message files out of the priority subdirectories of each input queue, start the MTA, then 
copy the message files back in groups, watching the MTA carefully to see if it shuts down on a 
particular message file. If it does, delete the problem message file so normal processing can 
resume. 


Occasionally, a damaged domain database (wpdomain.db) can cause the MTA to shut down. 


In ConsoleOne, perform maintenance to correct any problems with the domain database. See 
“Maintaining Domain and Post Office Databases” in “Databases” in the GroupWise 6.5 
Administration Guide. 


Network connections are unstable. 


Make sure the connections between the server where the MTA is running and the servers where 
the domain database (wpdomain.db) and post office database (wphost.db) are located are stable. 
Repeatedly losing connections to servers can cause damage to databases. 


The MTA is encountering a problem with one specific aspect of its functioning. 


MTA startup switches are available to disable specific MTA functions while allowing other 
functions to continue normally. For example, the /noada switch disables the MTA admin thread. 
If a specific MTA function is causing the MTA to shut down, you might be able to disable that 
particular function with a startup switch. See “Using MTA Startup Switches” in “Message Transfer 
Agent” in the GroupWise 6.5 Administration Guide. 


Another program on the server is interfering with the operation of the MTA. 


If the MTA continues to be unstable, eliminate other programs running on the server. If the MTA 
is stable when another specific program is not running on the same server with it, a conflict might 
exist between the two programs. 


MTA Status Box Shows a Closed Location 


Problem: 


Action: 


Action: 


At the MTA agent console, the Status box shows a closed location. 


Check for details about why the location is closed. See “Displaying MTA Status Information” in 
“Message Transfer Agent” in the GroupWise 6.5 Administration Guide. 


Check the configuration status for the closed location. See “MTA Configuration Status Isn't Open” 
on page 35. 
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Action: 


Action: 


Action: 


Possible Cause: 


Action: 


Possible Cause: 


Action: 


Check the last closure reason. This information can help you determine the source of the problem. 
Common last closure reasons include: 


Access denied 

Cannot attach to server or volume 
Cannot create/read/write files/directories 
Cannot move files 

Insufficient disk space 

Insufficient memory 

Insufficient system resources 

Link or transport down 

No path configured 

Undefined link 


See “Message Transfer Agent Error Messages” in GroupWise 6.5 Troubleshooting 1: Error 
Messages. 


In Configuration Status Details, check the directory paths for mapped and UNC connections or the 
IP addresses and port numbers for TCP/IP links. Make sure the correct locations are displayed. 
Make sure the locations exist, and verify the database (wpdomain.db for a domain or wphost.db 
for a post office) is there in the specified location. Do not use NDS® paths. 


If it is a new location that has never been open, verify the links between domains and post offices. 
See “Understanding Link Configuration” in “Domains” in the GroupWise 6.5 Administration 
Guide. Make sure mapped and UNC path specifications are in the correct format. Do not use NDS 
full context paths. 


A domain or post office has been moved incorrectly. 


When you move a domain or post office to a new location or change its link type, you must make 
various configuration changes in ConsoleOne. If the domain or post office becomes closed as a 
result, the reconfiguration changes might not have replicated down to the agent in the reconfigured 
location before other changes prevented the replication from happening at all. Rebuild the location 
database (wpdomain.db or wphost.db). See “Rebuilding Domain or Post Office Databases” in 
“Databases” in the GroupWise 6.5 Administration Guide. This will ensure the reconfiguration 
changes are replicated to the location. Then restart the agent for the location. 


The MTA server has insufficient memory. 


Make sure the server where the MTA is running has adequate memory. If the MTA starts running 
out of memory, it starts shutting down connections. See “Agent System Requirements” in 
“Installing GroupWise Agents” in the GroupWise 6.5 Installation Guide. 


MTA Statistics Box Shows Undeliverable Messages 


Problem: 


Action: 


At the MTA agent console, the Statistics box displays a large number of undeliverable messages. 


The number of undeliverable messages indicates how many messages could not be routed by the 
MTA. For strategies, see “Message Has Undeliverable Status” on page 73. 


MTA Statistics Box Shows Errors 
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Problem: 


Action: 


At the MTA agent console, the Statistics box shows a large number of message errors have 
occurred. 


The number of message errors indicates how many messages could not be processed by the MTA. 
For strategies, see “Message Is Dropped in the problem Directory” on page 77. 
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MTA Configuration Status Isn't Open 


Problem: 


Action: 


Action: 


Action: 


At the MTA agent console, the Configuration Status box displays the connection status as 
something other than Open. 


If the configuration status is Closed, the MTA cannot access the database in the domain or post 
office. Make sure the server where the closed location resides is not down. Make sure the MTA 
can access the server. 


NetWare Note: If you are using the NetWare MTA, verify the settings of the /dn or /user and / 
password startup switches for the server where the closed location resides. 


Windows Note: If you are using the Windows MTA, verify the UNC path or drive mapping to the 
closed location. 


If the connection status is Suspended, resume the MTA. See “Suspending/Resuming MTA 
Processing for a Location” in “Message Transfer Agent” in the GroupWise 6.5 Administration 
Guide. 


If the connection status is Open Pending, post offices in the domain are in the process of opening 
and the MTA is clearing its holding queues. After this is accomplished, the MTA begins 
processing current messages and the status will change to Open. No action is necessary. 


MTA Fails to Update the Domain Database Version 


Problem: 


Possible Cause: 


Action: 


Action: 


You are updating the MTA software in a secondary domain and the MTA fails to update the 
database version for the domain. You might see conflicting database version information 
depending on whether you are connected to the secondary domain or the primary domain. 


You installed and started the MTA for the secondary domain before the MTA for the primary 
domain had finished updating the primary domain database. 


Wait until the MTA for the primary domain has finished updating the primary domain database. 
For a large domain database, you might need to wait as much as 20 minutes or more. Verify that 
the primary domain database version has been updated by checking the Domain object’s 
Identification page in ConsoleOne. Then stop and restart the MTA for the secondary domain to 
update the secondary domain database. 


If restarting the MTA for the secondary domain does not update the domain database version: 


1 Compare the dates on the .dc files (gwdom.dc and gwpo.dc) in the secondary domain 
directory with the dates on the .dc files in the update source (the GroupWise 6.5 Administrator 
CD or the software distribution directory if it has been updated from the GroupWise 6.5 
Administrator CD). 


2 Ifthe dates on the .dc files in the secondary domain are older than the dates on the .dc files in 
the update source, copy the .dc files from the update source into the domain directory. 


3 At the MTA console, recover the domain database. See “Recovering the Domain Database 
Automatically or Immediately” in “Message Transfer Agent” in the GroupWise 6.5 
Administration Guide. 


When the recovery process is finished, the database version should be updated. 


4 In ConsoleOne, connect to the secondary domain, then check the Domain object’s 
Identification page to verify that the database version has been updated. 


5 Connect to the primary domain database, then check the Identification page for the primary 
domain to verify that the database version information matches in both domain databases. 


Message Transfer Agent Problems 35 


Action: 


Possible Cause: 


Action: 


If recovering the secondary domain database does not update the version, then connect to the 
primary domain and rebuild the secondary domain database. See “Rebuilding Domain or Post 
Office Databases” in “Databases” in the GroupWise 6.5 Administration Guide. 


There are one or more closed links between the secondary domain and the primary domain that are 
preventing the administrative messages from flowing between the domains to accomplish the 
database version update. 


Check the links between the domains and open any closed links. See “MTA Configuration Status 
Isn't Open” on page 35. After all links are open, recover the secondary domain database. See 
“Recovering the Domain Database Automatically or Immediately” in “Message Transfer Agent” 
in the GroupWise 6.5 Administration Guide. 


MTA Starts in the Wrong Language 


Problem: 


Action: 


You have installed the MTA in more than one language and it is starting in a different language 
than you want. 


Start the MTA using the /language switch to specify the language. 


MTA Is Involved with Network Operating System or Hardware Problems 
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Problem: 


Possible Cause: 


Action: 


Possible Cause: 


Action: 
Possible Cause: 


Action: 


The MTA is interacting with the network operating system or hardware in an undesirable way. 


If you just updated the MTA software, you might not have unloaded the agent engine 
(gwenn4.nlm), resulting in a series of "Loader cannot find public symbol: symbol" errors on the 
server console. 


Unload gwenn4.nlm, then start the MTA, so that the newly installed agent engine is loaded along 
with it. 


The MTA server is running older software, resulting in TCP_HANDLER errors on the server 
console. 


Make sure you are using the most current TCP/IP stack for NetWare. 
The MTA server is overburdened, resulting in SYN attacks. 


Make sure overall server utilization is not to high. Increase the MTA's tolerance for slow 
connections. See “Adjusting the MTA Wait Intervals for Slow TCP/IP Connections” in “Message 
Transfer Agent” in the GroupWise 6.5 Administration Guide. 
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Internet Agent Problems 


+ “No Relay Host Connectivity from Target Server” on page 38 

+ “No Internet Connectivity from Target Server” on page 39 

+ “Target Server Could Not Perform DNS Resolution” on page 41 
+ “Target Server Not Configured for TCP/IP” on page 42 

+ “Invalid or Unspecified Internet Host Name” on page 42 

+ “Unverified Host Name for Target Server” on page 43 

+ “RFC Compliance: Specify a Postmaster” on page 43 

+ “Log Files” on page 43 

+ “Internet Agent Not Sending Messages” on page 45 

+ “Internet Agent Not Receiving Messages” on page 45 

+ “Internet Agent Locking Up” on page 45 

+ “Internet Agent Cannot Access the Domain” on page 46 

+ “Internet Agent Doesn’t Send Outgoing Mail” on page 46 

+ “Internet Agent Fails to Respond to Configuration Changes Made in ConsoleOne” on page 46 


+ “Administrator Wants to Prevent Certain Types of Messages from Passing through the 
Internet Agent” on page 47 


+ “POP3 Client Users Can't Send Internet Mail through the Internet Agent” on page 47 


+ “POP3 Client Users Can't Access the GroupWise Address Book through the LDAP Services 
of the Internet Agent” on page 47 


+ “IMAP4 Client Users Can't Access Mail through the Internet Agent” on page 48 


+ “Extended Characters in User Names Prevent Delivery through the Internet Agent” on 
page 48 


+ “Messages Sent Out through the Internet Agent Don't Wrap When Displayed by Recipients” 
on page 48 


+ “The Internet Agent Cannot Communicate with the Message Transfer Agent (MTA)” on 
page 49 


+ “The Internet Agent Displays a 450 MX Record Lookup Failure” on page 49 
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No Relay Host Connectivity from Target Server 


Problem: During installation, the Internet Agent Installation program was not able to contact a mail process 
on the specified relay host. You can fix the problem after the Internet Agent has been installed. 


Possible Cause: The server where you installed the Internet Agent is not yet configured for TCP/IP. 
Action: On a NetWare® server: 
1 Load INETCFG. 
2 In the Internetworking Configuration box, select Protocols > TCP/IP. 
3 Select Enabled. 
4 Exit INETCFG. 
5 Restart the server. 


Refer to the NetWare documentation at the Novell® Documentation Web site (http:// 
www.novell.com/documentation) for more information about configuring TCP/IP on NetWare. 


Action: Ona Windows server: 


1 For Windows 2000, right-click My Network Places, click Properties, then double-click Local 
Area Connection. 


or 
For Windows NT, right-click Network Neighborhood, then click Properties > Protocols. 
2 Check the list for Internet Protocol (TCP/IP). 
3 If TCP/IP is not in the list, click Add, then follow the instructions for installing TCP/IP. 
or 
If TCP/IP is listed, select it, then check the existing configuration information for accuracy. 
4 Click OK to save any changes you have made. 
5 Restart the server. 
Refer to your Windows documentation for more information about installing TCP/IP on Windows. 


Possible Cause: The server where you installed the Internet Agent cannot communicate with the relay host because 
the default router is not properly configured. 


Action: Ona NetWare server, if you are configuring TCP/IP in the AUTOEXEC.NCF file, add 
gateway=router_ip_address to the BIND statement. 


If you are using INETCFG to configure TCP/IP: 
1 Load INETCFG. 
2 In the Internetworking Configuration box, select Protocols. 
3 In the Protocol Configuration box, select TCP/IP. 
4 In the TCP/IP Protocol Configuration box, 
4a Enable Static Routing. 
4b Select Static Routing Table. 
4c Press Enter. 
5 In the TCP/IP Static Routes box, press Insert to add a new static route. 
6 In the Static Route Configuration box, 
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Action: 


Possible Cause: 
Action: 


Action: 


Ga Press Enter in the Route Type field to display a list of route types. 
6b Select Default Route. 
6c Select Next Hop Router on Route, then press Enter to edit the field. 
6d Type the IP address of the default router, then press Enter. 
Ge Press Esc twice. 

7 Select Yes, then press Enter to update the INETCFG database. 

8 Press Esc until prompted to exit INETCFG. 

9 Select Yes, then press Enter. 

10 Restart the server to put the new default router into effect. 


Refer to the NetWare documentation at the Novell Documentation Web site (http:// 
www.novell.com/documentation) for more information about using INETCFG. 


On a Windows server: 
1 Click Start > Settings > Control Panel. 


2 On Windows 2000, double-click Network and Dial-Up Connections, then click Local Area 
Connection. 


or 
On Windows NT, double-click Network, then click Protocols. 

Select TCP/IP Protocol, then click Properties. 

In the Default Gateway field, specify the IP address of the default router on your network. 
Click OK. 


a Aà Q 


6 Restart the server to put the new default gateway information into effect. 
Refer to your Windows documentation for more information about installing TCP/IP on Windows. 
There is no SMTP mail service listening at the IP address of the relay host. 
Start the mail service on the relay host. 


Specify a different relay host. 


No Internet Connectivity from Target Server 


Problem: 


Possible Cause: 


Action: 


During installation, the Internet Agent Installation program was not able to connect to the Internet. 
You can fix the problem after the Internet Agent has been installed. 


The server where you installed the Internet Agent is not yet configured for TCP/IP. 
On a NetWare server: 
1 Load INETCFG. 
2 In the Internetworking Configuration box, select Protocols, then select TCP/IP. 
3 Select Enabled. 
4 Exit INETCFG. 
5 Restart the server. 


Refer to the NetWare documentation at the Novell Documentation Web site (http:// 
www.novell.com/documentation) for more information about configuring TCP/IP on NetWare. 


Internet Agent Problems 39 


Action: Ona Windows server: 


1 For Windows 2000, right-click My Network Places, click Properties, then double-click Local 
Area Connection. 


or 
For Windows NT, right-click Network Neighborhood, then click Properties > Protocols. 
2 Check the list for Internet Protocol (TCP/IP). 
3 If TCP/IP is not in the list, click Add, then follow the instructions for installing TCP/IP. 
or 
If TCP/IP is listed, select it, then check the existing configuration information for accuracy. 
4 Click OK to save any changes you have made. 
5 Restart the server. 
Refer to your Windows documentation for more information about installing TCP/IP on Windows. 


Possible Cause: The server where you installed the Internet Agent cannot communicate with the Internet because 
the default router is not properly configured. 


Action: Ona NetWare server, if you are configuring TCP/IP in the autoexec.ncf file, add 
gateway=router_ip_address to the BIND statement. 


If you are using INETCFG to configure TCP/IP: 
1 Load INETCFG. 
2 In the Internetworking Configuration box, select Protocols. 
3 In the Protocol Configuration box, select TCP/IP. 
4 In the TCP/IP Protocol Configuration box, 
4a Enable Static Routing. 
4b Select Static Routing Table. 
4c Press Enter. 
5 In the TCP/IP Static Routes box, press Insert to add a new static route. 
6 In the Static Route Configuration box, 
6a Press Enter in the Route Type field to display a list of route types. 
6b Select Default Route. 
6c Select Next Hop Router on Route, then press Enter to edit the field. 
Gd Type the IP address of the default router, then press Enter. 
Ge Press Esc twice. 
7 Select Yes, then press Enter to update the INETCFG database. 
8 Press Esc until prompted to exit INETCFG. 
9 Select Yes, then press Enter. 
10 Restart the server to put the new default router into effect. 


Refer to the NetWare documentation at the Novell Documentation Web site (http:// 
www.novell.com/documentation) for more information about using INETCFG. 
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Action: 


Possible Cause: 


Action: 


Action: 


Possible Cause: 


Action: 


On a Windows server: 


1 For Windows 2000, right-click My Network Places, click Properties, then double-click Local 
Area Connection. 


or 

For Windows NT, right-click Network Neighborhood, then click Properties > Protocols. 
Select Internet Protocol (TCP/IP), then click Properties. 

In the Default Gateway field, specify the IP address of the default router on your network. 
Click OK. 


h O N 


5 Restart the server to put the new default gateway information into effect. 


Refer to your Windows documentation for more information about setting up a default router on 
Windows. 


A firewall is blocking SMTP traffic. 


Configure the firewall to allow outbound messages to pass if the source IP address is the IP address 
of the server where you installed the Internet Agent. Also configure the firewall to allow inbound 
messages to pass if the destination IP address is the IP address of the server where you installed 
the Internet Agent. In both cases, the required port number is 25. 


As needed, configure the firewall to accept the following additional types of traffic: POP3 (port 
110), IMAP4 (port 143), or LDAP (port 389). 


You are using a dial-up connection to the Internet and it is not configured to dial on demand. 


Refer to the documentation accompanying the dial-up router or contact the router software vendor. 


Target Server Could Not Perform DNS Resolution 


Problem: 


Possible Cause: 


Action: 


Action: 


Possible Cause: 
Action: 


Action: 


During installation, the Internet Agent Installation program determined that the server where you 
installed the Internet Agent cannot resolve DNS (Domain Name Service) host names. You can fix 
the problem after the Internet Agent has been installed. 


The server where you installed the Internet Agent is not yet configured for DNS. 


On a NetWare server, make sure that DNS has been set up as described in “Internet Connectivity 
Requirements” in “Installing the GroupWise Internet Agent” in the Group Wise 6.5 Installation 
Guide. 


On a Windows server: 


1 For Windows 2000, right-click My Network Places, click Properties, then double-click Local 
Area Connection. 


or 
For Windows NT, right-click Network Neighborhood, then click Properties > Protocols. 

2 Select Internet Protocol (TCP/IP), then click Properties > DNS. 

3 Add or correct DNS information as needed. 

4 Click OK to save any changes you have made. 
Refer to your Windows documentation for more information about setting up DNS on Windows. 
The DNS server is down or otherwise unavailable. 
Contact the administrator of the DNS server to resolve the issue. 


Configure the server where you are installing the Internet Agent to use a different DNS server. 
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Target Server Not Configured for TCP/IP 


Problem: During installation, the Internet Agent Installation program determined that the server where you 
installed the Internet Agent is not configured for TCP/IP. You can fix the problem after the Internet 
Agent has been installed. 


Action: Ona NetWare server: 
1 Load INETCFG. 
2 In the Internetworking Configuration box, select Protocols > TCP/IP. 
3 Select Enabled. 
4 Exit INETCFG. 
5 Restart the server. 


Refer to the NetWare documentation at the Novell Documentation Web site (http:// 
www.novell.com/documentation) for more information about configuring TCP/IP on NetWare. 


Action: Ona Windows server: 


1 For Windows 2000, right-click My Network Places, click Properties, then double-click Local 
Area Connection. 


or 
For Windows NT, right-click Network Neighborhood, then click Properties > Protocols. 
2 Check the list for Internet Protocol (TCP/IP). 
3 If TCP/IP is not in the list, click Add, then follow the instructions for installing TCP/IP. 
or 
If TCP/IP is listed, select it, then check the existing configuration information for accuracy. 
4 Click OK to save any changes you have made. 
5 Restart the server. 


Refer to your Windows documentation for more information about installing TCP/IP on Windows. 


Invalid or Unspecified Internet Host Name 


Problem: During installation, you did not specify a valid Internet host name for the Internet Agent to use 
when resolving Internet addresses. You can fix the problem after the Internet Agent has been 
installed. 


Possible Cause: The Internet host name is not yet stored in NDS. 


Action: In ConsoleOne,” browse to and right-click the GWIA object, then click Properties. Click 
Group Wise > Identification. In the Foreign ID field, provide the Internet host name of your 
company (for example, Novell.com). 


Possible Cause: The host name you provided has not been registered and published by your ISP. 


Action: Contact your ISP to find out when your host name will be published. Make sure that your ISP has 
associated the correct IP address with your host name. Verify the contents of the MX and A records 
for your host name. 


Possible Cause: Your host name as been published for less than 24 hours and your DNS server is still using cached 
information. 


Action: Wait a day and try again. 
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Possible Cause: 


Action: 


Action: 


Inbound mail is routed through a relay host. 


You can ignore this warning if the relay host is configured to forward messages to the server where 
the Internet Agent is installed. 


If the relay host uses aliasing to forward messages to the server where the Internet Agent is 
installed, you must configure the Internet Agent to handle the alias. In ConsoleOne, browse to and 
right-click the GWIA object, then click Properties. Click GroupWise > Identification. In the 
Foreign ID field, provide the alias along with the Internet host name of your company. Separate 
the hostnames with a space. 


Unverified Host Name for Target Server 


Problem: 


Action: 


Action: 


During installation, the Internet Agent Installation program determined that the server where you 
installed the Internet Agent does not have a host name. You can fix the problem after the Internet 
Agent has been installed. 


On a NetWare server, make sure that the server where you installed the Internet Agent is listed in 
the sys:\etc\hosts file, including its host name and IP address. 


On a Windows server: 


41 For Windows 2000, right-click My Network Places, click Properties, then double-click Local 
Area Connection. 


or 
For Windows NT, right-click Network Neighborhood, then click Properties > Protocols. 

2 Select Internet Protocol (TCP/IP), then click Properties > DNS. 

3 Fill in the Host Name and Domain fields. 

4 Click OK to save any changes you have made. 


Refer to your Windows documentation for more information about setting up DNS on Windows. 


RFC Compliance: Specify a Postmaster 


Problem: 


Action: 


Log Files 


Explanation: 


Action: 


During installation, you did not specify a postmaster for the Internet Agent to send error 
notifications to. You can fix the problem after you have finished installing the Internet Agent. 


Follow the instructions in “Assigning a Postmaster ” in “Installing the GroupWise Internet Agent” 
in the GroupWise 6.5 Installation Guide. 


The log file is a useful tool for diagnosing problems. It is an ASCII file that records Internet Access 
activity and provides a variety of configuration, message flow, and productivity information. The 
log file contains the same information that scrolls in the message log portion of the of the Internet 
Agent console. 


You can adjust the amount of information a log file records using the Log Settings page in 
ConsoleOne, the log startup switches, or the keystroke menu in the Internet Agent console. For 
more information, see “Using Internet Agent Log Files” in “Internet Agent” in the GroupWise 6.5 
Administration Guide. 
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SMTP Statistics 


Explanation: 


Action: 


The Statistics screen, which is accessed from the Internet Agent console, lists numbers of error and 
informational messages. Most of these messages are informational only. 


Use the information on the Statistics screen to help you resolve Internet Agent problems. 


Messages Sent/Messages Received: These fields display the number of messages the Internet 
Agent has sent and received. 


Send Threads/Receive Threads: These fields display the number of currently active send and 
receive threads the Internet Agent is using to process outgoing and incoming messages. If the 
number of send or receive threads currently in use is consistently close to the total number 
allocated, you might want to increase the total number of send or receive threads. 


Send Thr Avail/Receive Thr Avail: These fields display the number of available send and 
receive threads of the total number allocated. 


MX Lookup Errs: This field displays the number of times the Internet Agent queries the Domain 
Name Server (DNS) for the address of the destination host and receives a SERVER FAIL code 
message back from the DNS. These messages will be deferred and automatically re-queued 
according to the retry schedule. 


Unless the number of MX Lookup Errors is very significant, do not be concerned by these 
messages. If the number of messages is very significant, you might want to check the DNS to make 
sure the tables are not corrupted. If you’re using a remote DNS, you might consider setting up a 
local DNS server. It could also mean that your file server TCP/IP is not correctly configured. 


Unknown Hosts: This field displays the number of times the Internet Agent attempted to do a 
lookup on a destination host and the host name did not exist in either the DNS records or in the 
host table. The Internet Agent sends back a non-deliverable message to the sender for each 
Unknown Host message. 


TCP/IP Read Errs/ TCP/IP Write Errs: These fields display the number of TCP/IP read or write 
errors indicating some communication problem occurred. This is a temporary error. These 
messages will be deferred and automatically re-queued according to the retry schedule. Unless the 
number of TCP/IP read or write errors is very significant, do not be concerned by these messages. 
If the number of messages is very significant, you might want to contact your Internet service 
provider to check for anything that could hinder communication, such as network problems or line 
noise. You might also want to adjust the timeout switches, particularly the /te and /tr switches. 


Hosts Down: This field displays the number of times the Internet Agent tried to open a connection 
with the destination host and received a connection refused status. This is a temporary error. These 
messages will be deferred and automatically re-queued according to the Retry Schedule. 


The statistics count the number of times a code or SMTP reply, such as Host Down, comes back 
to the Internet Agent. It does not keep track of the mail messages causing these replies. If, for 
example, a message is deferred and re-queued for four days during the Retry Schedule, each 
attempt the program makes to send the message results in another SMTP reply or error code. 


Retry Schedule: If an Internet host is down or the connection is not made on the Internet, the 
Internet Agent defers the message and re-queues it according to the retry schedule. The Internet 
Agent program places the message in the \wpgate\gwia\defer directory for 20 minutes. Then it 
transfers the file to the send directory for another attempt at sending to the Internet. The Internet 
Agent makes this attempt three times in one hour and then every four hours for four days. After 
the four days, if the Internet host remains down, an undeliverable status is sent back to the sender. 
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Internet Agent Not Sending Messages 


Problem: 


Action: 
Action: 
Action: 


Action: 


Action: 


Action: 


Action: 


Messages are not returned to the user’s Sent Items folder as undeliverable, and the recipients are 
not receiving the messages. 


Make sure the Internet Agent is running and is correctly configured in ConsoleOne. 
Make sure the Message Transfer Agent is running. 


Make sure the Internet Agent can access the Group Wise® domain directory. 


Make sure the program is properly configured. Check the startup file to verify that the /dhome 
switch is pointing to the Internet Agent directory. 


Check the statistics from the Internet Agent console. If any of the fields, such as TCP/IP Read or 
Write Errors or MX Lookup Errors, have a very significant number, you might want to contact 
your Internet service provider. See “SMTP Statistics” on page 44 for more information. 


Check the log file for error messages. You might want to set the log level to Diag and resend 
problem messages. See “Internet Agent Error Messages” in GroupWise 6.5 Troubleshooting 1: 
Error Messages for more information. 


Make sure the resolv.cfg file is set up correctly. See “Internet Connectivity Requirements” in 
“Installing the GroupWise Internet Agent” in the GroupWise 6.5 Installation Guide. 


Internet Agent Not Receiving Messages 


Problem: 
Action: 
Action: 


Action: 


Action: 


Action: 


Action: 


The Internet Agent is not receiving messages from the Internet. 
Make sure the Internet Agent directory has sufficient network rights. 
Make sure the Internet Agent can access the GroupWise domain database. 


Make sure the Internet Agent has rights to the domain directory and that the Internet Agent can 
access all its subdirectories. 


Make sure the program is properly configured. Check the startup file to verify that the /dhome 
switch is pointing to the Internet Agent directory. 


Check if you can ping the Internet Agent server from another Internet server. 


Send a test message from a UNIX* Internet computer using the sendmail -v option. The -v option 
shows all the SMTP reply codes for the message. For example, use the following syntax: 


echo test | /usr/lib/sendmail -v user@host 


Internet Agent Locking Up 


Problem: 
Possible Cause: 
Possible Cause: 
Possible Cause: 
Possible Cause: 
Possible Cause: 
Possible Cause: 


Action: 


The Internet Agent locks up or hangs. 

Bad message file 

Bad configuration file in the 000.pre directory 
Bad domain record 

Bad domain user record 

Software incompatibility 

Hardware failure 


Check the dates of the executables and make sure you are using the most current software and 
patches. Apply the latest versions for the Internet Agent as well as for the TCP/IP kernel. Make 
sure you meet the minimum version and system requirements for the operating system. 
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Action: 


Action: 


Action: 


Action: 


Action: 


Check for bad message files. Move all files currently in any queues in the send, receive, defer, 
result, wpcsin, wpcsout, or 000.pre\gwwork directories and let the Internet Agent run idle without 
processing any messages. If the Internet Agent can run idle without locking, a bad message is 
probably causing it to lock. Start copying the files back to the appropriate directory queues starting 
with the newest file to the oldest. This approach assumes the oldest file caused the lock and allows 
the Internet Agent to process the messages that got backed up before dealing with the bad file. 
Delete the bad file when you find it. Because the file is encrypted, there is no way to determine 
who sent the message. 


Check for a bad configuration file. One of the setup files in the 000.pre directory might be damaged 
and therefore causing problems. Before removing or changing anything, back up your directories. 
Be sure to back up any files you want in the 000.prc directory such as the log and accounting files. 
Remove all the files in the 000.pre and restart the Internet Agent. If you had set a screen color or 
screen saver, you will have to reset these settings after removing the SET file. 


Remove directories and have the Message Transfer Agent and the Internet Agent re-create new 
ones. Be sure to back up the whole GWIA directory and all subdirectories before deleting 
anything. Shut down the Internet Agent and the Message Transfer Agent. Remove the send, 
receive, defer, result, wpcsin, wpcsout, 000.prc directories. Restart the Message Transfer Agent 
first to re-create the wpcsin and wpcsout directories, then restart the Internet Agent to re-create the 
other directories (empty). This approach is often effective for solving locking problems, although 
it is not very effective for isolating and determining what is causing the problem. 


If the Internet Agent continues to lock after removing and re-creating the directories, you might 
want to rebuild the domain database for the domain where the Internet Agent is installed in case 
there are database structural problems. If it’s a primary domain database, you’ll have to rebuild the 
database from itself. If it’s a secondary domain database, you can rebuild it from the primary 
domain database or rebuild it from itself. 


Run the Internet Agent on a different server that is already set up and running well (without 
problems with requestors, network interface cards, and so on). If the Internet Agent runs well with 
the same configuration on a different server, then the hardware is probably causing problems. 


Internet Agent Cannot Access the Domain 


Problem: 


Explanation: 


Action: 
Action: 


Action: 


The Internet Agent cannot access its input and output queues in the domain. 


When the domain is located on a remote NetWare server, the Internet Agent must be started with 
the /user and /password switches so it can log in to the remote server. 


Make sure these switches have been specified in the Internet Agent .cfg file. 
Make sure the user has sufficient rights to access the \domain\wpgate\gwia directory. 


Make sure the password is correct and current. 


Internet Agent Doesn’t Send Outgoing Mail 


Problem: 


Action: 


The Internet Agent seems to receive and process messages, but never sends them. 


If you are using an external domain to simplify addressing for your users, make sure the external 
domain type is set to Non-Group Wise Domain, not External Domain. In ConsoleOne, in the 
GroupWise View, delete the external domain, then create a non-Group Wise domain. 


Internet Agent Fails to Respond to Configuration Changes Made in ConsoleOne 


Problem: 


Action: 


You change an Internet Agent access control setting in ConsoleOne, but the Internet Agent does 
not respond to the change. 


Exit, then restart the Internet Agent so it rereads its access control database (gwac.db). 
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Administrator Wants to Prevent Certain Types of Messages from Passing through the Internet Agent 


Problem: 


Explanation: 


Action: 


Action: 


Action: 


Explanation: 


Action: 


Message flow through the Internet Agent is being hindered because large numbers of undesirable 
types of messages are passing through. 


You want to prevent messages larger than a specified size from coming into the Group Wise system 
through the Internet Agent. 


In ConsoleOne, browse to and select the domain where the Internet Agent is installed > right-click 
the Internet Agent object > click Properties > Access Control > double-click Default Class of 
Service. 


Exit, then restart the Internet Agent. 


To restrict the size of incoming messages, click SMTP Incoming, select Allow Incoming 
Messages, select Prevent Messages Larger than X Kbytes, specify the maximum message size in 
kilobytes, then click OK. 


Exit, then restart the Internet Agent. 


To restrict the size of outgoing messages, click SMTP Outgoing, select Allow Outgoing Messages, 
select Prevent Messages Larger than X Kbytes, specify the maximum message size in kilobytes, 
then click OK. 


Exit, then restart the Internet Agent. 


By default, the Internet Agent downloads only 100 messages at a time. You want to increase or 
decrease this number. 


In ConsoleOne, browse to and select the Domain object where the Internet Agent is installed. 
Right-click the Internet Agent object, then click Properties. Click Access Control, then double- 
click Default Class of Service. Click POP3, modify the setting in the Maximum Number of 
Messages to Download field as needed (valid settings range from 1 to 1000), then click OK. 


Exit, then restart the Internet Agent. 


POP3 Client Users Can't Send Internet Mail through the Internet Agent 


Problem: 
Possible Cause: 


Action: 


Users of POP3 mail clients are unable to send mail through the Internet Agent. 
Allow Message Relaying has been turned off. 


Make sure Allow Message Relaying is turned on. In ConsoleOne, browse to and select the Domain 
object where the Internet Agent is installed. Right-click the Internet Agent object, then click 
Properties.Click Access Control > SMTP Relay, select Allow Message Relaying, then click OK. 


Exit, then restart the Internet Agent. 


POP3 Client Users Can't Access the GroupWise Address Book through the LDAP Services of the 


Internet Agent 


Problem: 


Possible Cause: 


Action: 


POP3 client users cannot look up addresses using the LDAP directory services created in their 
browser. 


If you are using Netscape Communicator*, the Search Root setting does not match the Internet 
Agent LDAP Context setting. 


First, check the Search Root setting. In Netscape Communicator, click Edit > Preferences > Mail 
& Groups > Directory > GroupWise Address Book > Edit. Check the setting in the Search Root 
field. Note the current setting; it can be anything. Then, check the Internet Agent LDAP Context 
setting. In ConsoleOne, browse to and select the Domain where the Internet Agent is 

installed. Right-click the Internet Agent object, then click Properties. Click Advanced Settings. 
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Possible Cause: 


Action: 


Possible Cause: 


Action: 


Make sure the setting in the LDAP Context field matches the setting in the Netscape 
Communicator Search Root field. 


If you are using Internet Explorer, the Search Base setting does not match the Internet Agent 
LDAP Context setting. 


First, check the Search Base setting. In Internet Explorer, click File > New 

Message > Mail > Choose Recipients > Find. Right-click in the Search window, then click 
Directory Services from the pop-up list. Click GroupWise Address 

Book > Properties > Advanced. Check the setting in the Search Base for this Directory Service 
field. It can be anything; it defaults to c=US. Then, check the Internet Agent LDAP Context 
setting. In ConsoleOne, browse to and select the Domain object where the Internet Agent is 
installed. Right-click the Internet Agent object, then click Properties. Click Advanced Settings. 
Make sure the setting in the LDAP Context field matches the setting in the Internet Explorer 
Search Base field. 


The Internet Agent does not have access to a post office to retrieve information from the 
GroupWise Address Book by accessing a post office database (wphost.db). 


In ConsoleOne, browse to and select the Domain object where the Internet Agent is 

installed. Right-click the Internet Agent object, then click Properties.Click Access 

Control > LDAP Public, then make sure a valid post office has been specified. Make sure the post 
office access mode includes direct access. Make sure that message file processing has not been 
turned off. See “Adjusting the Number of POA Threads for Message File Processing” in “Post 
Office Agent” in the GroupWise 6.5 Administration Guide. 


IMAP4 Client Users Can't Access Mail through the Internet Agent 


Problem: 


Action: 


Users are unable to access GroupWise mail using IMAP4 from a browser because they are unable 
to log in. 


The user has Server Supports Encrypted Connections (SSL) turned on. In the user’s browser, 
check the setting for Server Supports Encrypted Connections (SSL). This is not currently 
supported by the Internet Agent. Deselect this option in the user’s browser. For example, in 
Netscape Communicator, click Edit > Preferences > Mail & Groups > Mail Server > deselect 
Server Supports Encrypted Connections (SSL) in the Mail Server Type box. 


Extended Characters in User Names Prevent Delivery through the Internet Agent 


Problem: 


Explanation: 


Action: 


Messages arriving from the Internet through the Internet Agent addressed to recipients who have 
extended characters in their user names are undeliverable. 


User names are part of message header files. According to RFC822 and RFC1521 standards, text 
in header fields must be composed of printable ASCII characters. 


As a workaround, create a nickname for affected users without the extended characters. See 
“Creating a Nickname for a User” in “Users” in the GroupWise 6.5 Administration Guide. 


Messages Sent Out through the Internet Agent Don't Wrap When Displayed by Recipients 


Problem: 


Action: 


Action: 


Recipients of Group Wise messages sent across the Internet through the Internet Agent complain 
that the messages do not wrap correctly when viewed in their e-mail client software. 


Enable line wrapping in the recipient's e-mail software. 


To specify how you want lines to wrap when displayed by the recipient, browse to and select the 
Domain object where the Internet Agent is installed. Right-click the Internet Agent object, 
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then click Properties. Click SMTP/MIME Settings > Message Formatting, specify a setting for 
Line Wrap Length for Message Text on Outbound Mail, then click OK. 


You can also specify the line wrap setting using the /wrap switch in the Internet Agent startup file 
(gwia.cfg). 


The line wrap setting affects only RFC822-formatted messages, not MIME messages. 


The Internet Agent Cannot Communicate with the Message Transfer Agent (MTA) 


Problem: 


Explanation: 


Action: 


Action: 


Action: 


Action: 


Action: 


The Internet Agent is not receiving messages to send out across the Internet. 


The Message Transfer Agent distributes messages between post offices, gateways, and domains. 
A Message Transfer Agent is required in each domain. If the Message Transfer Agent is offline, 
outgoing messages are queued in the Message Transfer Agent directories. When the Message 
Transfer Agent is brought online, all queued messages are routed. 


Make sure the Message Transfer Agent is running and transferring messages. See “Monitoring the 
MTA” in “Message Transfer Agent” in the GroupWise 6.5 Administration Guide. 


Make sure the Message Transfer Agent is correctly configured in ConsoleOne. See “Configuring 
the MTA” in “Message Transfer Agent” in the GroupWise 6.5 Administration Guide. 


Check the Message Transfer Agent console or the Message Transfer Agent log files. Both of these 
sources provide a detailed record of Message Transfer Agent operations. See “Using the MTA 
Agent Console” and “Using MTA Log Files” in “Message Transfer Agent” in the GroupWise 6.5 
Administration Guide. 


Check the Status portion of the MTA agent console to find out whether the domain, post office, or 
gateway is closed. See “MTA Status Box Shows a Closed Location” on page 33. 


Make sure you can send messages between post offices. See “Message Does Not Arrive between 
Post Offices” on page 59. 


The Internet Agent Displays a 450 MX Record Lookup Failure 


Problem: 


Action: 


Possible Cause: 

Action: 
Possible Cause: 
Possible Cause: 


Possible Cause: 


The Internet Agent has requested a lookup from the Domain Name Server and did not get a 
response. 


Check the resolv.cfg file for correct configuration. 
The resolv.cfg file should be in the following format: 


domain your domain name 
nameserver ip address 
nameserver ip address 
nameserver ip address 


The domain name is first, followed by up to three nameserver IP addresses. The following is a 
sample resolv.cfg file: 


domain sgunix.org 
nameserver 172.16.5.18 


The IP address to your DNS has changed. 

Update the resolv.cfg file. 

TCP/IP is configured incorrectly. 

There is a problem with your network interface card. 


There is a problem with your network cabling. 
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Possible Cause: The DNS server is down. 

Possible Cause: IP filtering has been added to the routers so the Internet Agent cannot see the DNS server. 
Action: Ping the nameserver IP address to see if it is reachable from the gateway station. 
Action: Ping the LAN segment router IP address. 
Action: Make sure the named Internet Agent program is running on the nameserver server. 


Possible Cause: Outbound ports are disabled. TCP/IP can use port 1024 through 2099 or some other range of 
outbound ports for sending. 


Action: | Check with your Internet service provider for the outbound ports it uses. 


The Internet Agent Experiences a Problem with Rules Causing Looping 


Problem: An infinite message loop can occur when a user has turned on a rule automatically replying to 
messages. If a message is then sent to another user who has an automatic reply rule, or to a list 
server, an infinite loop can occur. 


Explanation: GroupWise has built-in counters to prevent most infinite loops, primarily those occurring within 
the GroupWise system. The following safeguards have been implemented by the Group Wise 
Internet Agent to prevent the looping of messages that go through the gateway: 


+ Messages generated by a rule now have the From address changed to 
POSTMASTER@foreign_name. 


+ A Reply To: field has been added with the real user address so most mailers will reply to the 
user, but list servers that reply to the From address will reply to the postmaster instead. 


+ An Errors To: field has been added with the POSTMASTER foreign name address. With this 
field, undeliverable messages won’t be sent to a mailbox that has a rule associated with it. 


+ Ifa message is sent to a user that is defined on a foreign domain or gateway, the Reply To: 
field will contain the postmaster’s actual resolved address. This allows the postmaster 
message to get to a postmaster who might not be on the GroupWise system. 


Action: The infinite loop protection built into GroupWise might not work for some messages going 
through the gateway to Internet list servers. Such infinite loops must be resolved on a case-by-case 
basis. 
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WebAccess Agent Problems 


“GroupWise WebAccess Login Screen Does Not Appear” on page 51 
“Initial GroupWise WebAccess Screen Does Not Appear” on page 51 
“User is Logged Out of GroupWise WebAccess” on page 52 

“User Receives Invalid User ID or Password Error Message” on page 52 
“WebAccess Agent Cannot Access a Post Office” on page 52 
“WebAccess Agent Will Not Start” on page 53 

“WebAccess Agent Shuts Down Unexpectedly” on page 52 
“WebAccess Agent Doesn’t Create Log Files” on page 52 

“WebAccess Speller Doesn't Work” on page 53 

“WebAccess Client Doesn't Print Messages” on page 53 

“WebAccess Users Want to Skip the Language Selection Page” on page 53 


“Messages Viewed through WebAccess Client Could Be Viewed through Browser's History 
Cache” on page 53 


GroupWise WebAccess Login Screen Does Not Appear 


Explanation: 


Action: 


When a user clicks a language button on the initial GroupWise® WebAccess screen, the login 
screen does not appear. 


Make sure the commegr.cfg file is in the cgi-bin\gw5 of the Web Server. See “Configuring the 
WebAccess Agent” and “Configuring the WebAccess Application” in “WebAccess” in the 
GroupWise 6.5 Administration Guide. 


If you are running the GroupWise WebAccess CGI Extension on a Novell® Web server, make sure 
the srm.cfg file (in the web\config directory, where web is the Web server's root directory) includes 
the following line: 


loadablemodule /cgi-bin/gw6/gwweb.exe 
sys: web/cgi-bin/gw6/gwweb.nlm 


where web is the Web server's root directory and us is the language code. You must have an entry 
for each language you have installed. See “Specifying a WebAccess Agent in the WebAccess 
URL” in “WebAccess” in the GroupWise 6.5 Administration Guide. 


Initial GroupWise WebAccess Screen Does Not Appear 


Explanation: 


Action: 


Action: 


When a user enters the IP address or host name of the Web server, the initial Group Wise 
WebAccess page does not appear. 


Make sure the user is typing the correct IP address or host name. 


Make sure the Web server's default HTML page is the default page provided with GroupWise 
WebAccess or contains a link to the initial GroupWise WebAccess page. See “Web Server Default 
Page” in “Installing GroupWise WebAccess” in the GroupWise 6.5 Installation Guide. 


WebAccess Agent Problems 51 


User is Logged Out of GroupWise WebAccess 


Explanation: 


Action: 


A GroupWise WebAccess user is automatically logged out of GroupWise WebAccess after a 
period of time. 


Each user has a timeout period after which they will be logged out if they have not used 
GroupWise WebAccess. By default, this timeout period is 20 minutes. If necessary, you can 
modify the timeout setting. See “Controlling User Access to Mailboxes” in “WebAccess” in the 
GroupWise 6.5 Administration Guide. 


User Receives Invalid User ID or Password Error Message 


Explanation: 


Action: 


Action: 


Action: 


When logging in to GroupWise WebAccess, a user receives an invalid user ID or invalid password 
error. 


Make sure the user entered his or her GroupWise user ID or full name (as defined in NDS and the 
GroupWise Address Book). Make sure the user has a password on his or her mailbox and that the 
password was entered correctly. Passwords are case-sensitive. 


Make sure the user has access to GroupWise WebAccess. See “Controlling User Access to 
Mailboxes” in “WebAccess” in the GroupWise 6.5 Administration Guide. 


Make sure the WebAccess Agent has access to the user's post office. See “Managing Access to 
Post Offices” in “WebAccess” in the GroupWise 6.5 Administration Guide. 


WebAccess Agent Cannot Access a Post Office 


Explanation: 


Action: 


Action: 


Action: 


Action: 


When processing a request from a user, the WebAccess Agent could not access the user's post 
office. 


Make sure the link information for the post office is defined in ConsoleOne®. See “Managing 
Access to Post Offices” in “WebAccess” in the GroupWise 6.5 Administration Guide. 


If the WebAccess Agent is using direct access to the post office, make sure it has a user account 
that provides access to the post office server and appropriate rights to the post office directory 
structure. See “Domain and Post Office Access” in “Installing GroupWise WebAccess” in the 
GroupWise 6.5 Installation Guide 


If the WebAccess Agent is using client/server access to the post office, make sure TCP/IP is set 
up on the servers running the WebAccess Agent and the Post Office Agent. 


Make sure login to the post office is not disabled. See “Disabling a Post Office” in “Post Offices” 
in the GroupWise 6.5 Administration Guide. 


WebAccess Agent Doesn’t Create Log Files 


Explanation: 


Action: 


Disk logging is turned off by default, so the WebAccess Agent doesn't automatically create log 
files. 


To enable and configure disk logging, see “Configuring the WebAccess Agent” in “WebAccess” 
in the GroupWise 6.5 Administration Guide. 


WebAccess Agent Shuts Down Unexpectedly 


Explanation: 


Action: 


The WebAccess Agent (gwinter) has been running smoothly, but stops unexpectedly. 


If the WebAccess Agent is connecting to the post office directly, its processing can be disrupted 
by damaged databases just like the POA. To protect the stability of the WebAccess Agent, you can 
configure it to communicate with the POA by way of TCP/IP in client/server mode only, thus 
disallowing direct database accesses. See “Modifying Links to Post Offices” in “WebAccess” in 
the GroupWise 6.5 Administration Guide. 
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WebAccess Agent Will Not Start 
Explanation: The WebAccess Agent will not start. 


Action: Edit the strtweb6.ncf or strtweb6.bat file. Make sure the /home startup switch includes the 
complete path to domain\wpgate\webacc, where domain is the path to the domain directory and 
webacc is the gateway home directory. 


Action: For the NetWare® WebAccess Agent, make sure the /user and /password startup switches include 
the user ID and password for an account that gives the WebAccess Agent access to the domain 
directory. 


Action: For the WebAccess Agent, make sure the server is connected to the server where the domain 
directory resides. 


WebAccess Client Doesn't Print Messages 


Explanation: | When printing a message in the Java* version of the WebAccess client, only the header gets 
printed. 


Explanation: The Java version of the WebAccess client uses an applet to display messages. Not all browsers can 
print applets. 


Action: Run the HTML version of the WebAccess client to print messages. 


WebAccess Speller Doesn't Work 
Explanation: WebAccess users are unable to spell check their messages. 


Action: Spell checking capabilities are not automatically set up when WebAccess is installed. For setup 
instructions, see “Configuring the Novell Speller Application” in “WebAccess” in the GroupWise 
6.5 Administration Guide. 


WebAccess Users Want to Skip the Language Selection Page 


Explanation: By default, the WebAccess client starts on a page where you choose your display language. On a 
system where only one language is available, this is an unnecessary step. 


Action: After selecting the language, users can create a bookmark to the main WebAccess login page, so 
they never need to select the language again. 


Action: Create a link directly to the WebAccess login page from some other page convenient to users. 


Messages Viewed through WebAccess Client Could Be Viewed through Browser's History Cache 


Explanation: Some users might consider it a security breach that messages originally viewed through the 
WebAccess client could be viewed later through their browser's history cache. 


Explanation: The configuration of the browser cache and history list is each user's responsibility. 
p g y 


Action: To set cache options in Netscape Communicator, click Edit > Preferences > Advanced > Cache, 
then configure caching as needed to meet your security concerns. To control the length of your 
history list, click Edit > Preferences > Navigation, then set Visited Links Expire after N Days as 
needed. 


Action: To set cache options in Internet Explorer, click View > Internet Options > Temporary Internet 
Files > Settings. Configure caching as needed to meet your security concerns. To control the 
length of your history list, click View > Internet Options > History, then set Days to Keep Pages 
in History as needed. 
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Monitor Agent Problems 


“Monitor Agent Won't Start” on page 55 


Monitor Agent Won't Start 
Problem: The Monitor Agent does not start. 
Possible Cause: The /home switch is missing. 


Action: | Make sure the /home startup switch provides the correct path to the domain directory where the 
domain database (wpdomain.db) resides. See “Starting the Monitor Agent” in “Monitor” in the 
GroupWise 6.5 Administration Guide. 


Possible Cause: The server where the domain resides is down. 
Action: | Check the status of the server where the domain resides. 
Possible Cause: The domain database (wpdomain.db) is damaged. 


Action: Ifthe domain database (wpdomain.db) is available to the Monitor Agent but cannot be read, it 
might be damaged. In ConsoleOne®, perform maintenance to correct any problems with the 
domain database. See “Maintaining Domain and Post Office Databases” in “Databases” in the 
GroupWise 6.5 Administration Guide. 


Possible Cause: The Monitor Agent encounters an error condition. 


Action: Ifyou receive an error message when trying to start the Monitor Agent, look it up in “Monitor 
Agent and Application Error Messages” in GroupWise 6.5 Troubleshooting 1: Error Messages. 
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Strategies for Message Delivery Problems 


This part of Troubleshooting 2: Solutions to Common Problems helps you resolve problems with 
how the agents are interacting to deliver messages throughout your GroupWise® system. 


+ “Message Does Not Arrive” on page 59 

+ “Message Delivery Is Slow” on page 79 

+ “Message Has Undeliverable Status” on page 83 

+ “Message Is Dropped in the problem Directory” on page 87 
Other sources of assistance include: 


+ Novell Support (http://support.novell.com) 


+ Novell® Support Knowledgebase (http://support.novell.com/search/kb_index.jsp) 
+ GroupWise 6.x Support Forums (http://support.novell.com/forums/2gw.html) 


+ GroupWise Cool Solutions (http://www.novell.com/coolsolutions/gwmag/index.html) 
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Message Does Not Arrive 


Select the configuration where message flow has been disrupted: 
e “Message Does Not Arrive in the Local Post Office” on page 59 
+ “Message Does Not Arrive between Post Offices” on page 59 


+ “Message Does Not Arrive between Domains” on page 66 


Message Does Not Arrive in the Local Post Office 


Problem: A message from user A is not being delivered to user B in the same post office. This scenario 
would most likely occur when GroupWise” users connect to the post office using direct access 
mode. Direct access for clients is not recommended for GroupWise 6.x. 


Action: Ifyou are having problems with direct access using GroupWise 6.x, see the GroupWise 5.5 
Troubleshooting 2: Solutions to Common Problems (http://www.novell.com/documentation/lg/ 
gw55/index.html). 


Message Does Not Arrive between Post Offices 


Problem: A message from a user in Post Office A is not being delivered to a user in Post Office B in the same 
domain. 


Action: Review the stages of message flow between post offices. See “Message Delivery to a Different 
Post Office” in GroupWise 6.5 Troubleshooting 3: Message Flow and Directory Structure. 


Action: Answer the following question: 


Can other users in Post Office A send messages to other users in Post Office B? 


Yes See “Problem with an Individual User in Either Post Office” on page 60. 
No See “Problem between Post Offices for Multiple Users” on page 63. 
Don/t Know See “Problem between Post Offices for Multiple Users” on page 63. 


Problem with an Individual User in Either Post Office 
41 Stop the MTA for the domain. 


2 Have the user in Post Office A send a low priority test message to a recipient in Post Office 
B. (It's a good idea to test message flow using a low priority message because the low priority 
message queue is typically empty.) 


3 Check the post_office\wpcsin\6 directory in the sender's post office. 
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Has a new message file appeared in the post_office\wpcsin\6 directory? 

No The GroupWise client was unable to create the message file. The user might not 
have sufficient rights to the directory if using direct access mode. Correct the 
problem, then repeat the test. 


Yes The sender can successfully send messages. Continue below. 


4 Stop the POA for Post Office B. 
5 Restart the MTA in the domain. Observe the MTA agent console for any sign of problems. 
6 Check the post_office\wpcsout\ofs\6 directory in Post Office B. 


Has a new message file appeared in the post_office\wpcsout\ofs\6 directory? 
No See “Problem between Post Offices for Multiple Users” on page 63. 


Yes The message transferred successfully between post offices. Continue below. 


7 Restart the POA for Post Office B. Observe the POA agent console for any sign of problems. 
8 Recheck the post_office\wpcsout\ofs\6 directory in Post Office B. 


Has the message file disappeared from the post_office\wpcsout\ofs\6 directory? 


No The POA was unable to pick up the message. Correct the problem, then 
repeat the test. 


Yes The POA has successfully picked up the message. Continue below. 


9 Check the recipient's mailbox. 


Does the new message appear in the recipient’s mailbox? 


Yes The POA has successfully delivered the message this time. Repeat the test 
with a different user. 


No The POA was unable to deliver the message. Continue below. 


10 Check the ownership of the recipient's user database (userxxx.db). 


Does the ownership of the user database match the recipient's network login ID? 
No Reset the ownership on the userxxx.db file, then repeat the test. 


Yes Continue below. 


11 Check the ownership of the message database (msgvn.db) in the recipient's post office that 
corresponds to the message database assigned to the sender in the sender's post office. 


60 GroupWise 6.5 Troubleshooting 2: Solutions to Common Problems 


Is the ownership of the message database correct? 
No Reset the ownership on the msgnn.db, then repeat the test. 


Yes Continue below. 


12 In ConsoleOne®, perform maintenance to correct any problems with the databases. See 
“Maintaining User/Resource and Message Databases” in “Databases” in the GroupWise 6.5 
Administration Guide. Then repeat the test. 


13 Ifthe message flow problem has not been resolved by following the above troubleshooting 
steps, see Novell® Support (http://support.novell.com). 


Problem between Post Offices for Multiple Users 
41 Stop the MTA for the domain. 


2 Have the user in Post Office A send a low priority test message. (It's a good idea to test 
message flow using a low priority message because the low priority message queue is 


typically empty.) 
3 Check the post_office\wpcsin\6 directory in Post Office A. 


Has a new message file appeared in the post_office\wpcsin\6 directory? 


No See “Problem with an Individual User in Either Post Office” on page 60. 


Yes The sender can successfully send messages. Continue below. 


4 Stop the POA for Post Office B. 
5 Restart the MTA for the domain. Observe the MTA agent console for any sign of problems. 
6 Check the post_office\wpcsout\ofs\6 directory in Post Office B. 


Has a new message file appeared in the post_office\wpcsout\ofs\6 directory? 
No See “Problem with Access to Post Office B” on page 64. 


Yes The MTA has successfully transferred the file to the POA in the recipient's post 
office. Continue below. 


7 Restart the POA for Post Office B. Observe the POA agent console for any sign of problems. 
8 Recheck the post_office\wpcsout\ofs\6 directory in Post Office B. 


Has the message file disappeared from the post_office\wpcsout\ofs\6 directory? 


No The message transferred successfully between post offices, but the POA in 
Post Office B is unable to pick up the file. See Step 8 in “Problem with an 
Individual User in Either Post Office” on page 60. 


Yes The message transferred successfully between post offices, and the POA in 
Post Office B has picked up the file. If the message still does not arrive in the 
recipient's mailbox, see Step 9 through Step 13 in “Problem with an Individual 
User in Either Post Office” on page 60. 
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Problem with Access to Post Office B 
1 Start ConsoleOne with read/write rights to the post office. 
2 Open the browser window. 


3 Double-click the eDirectory™ container where the domain is located, then select the Domain 
object. 


4 Click Tools > GroupWise Utilities > Link Configuration. 
5 Check the link from the domain to Post Office B. 


Does the link from the domain to the post office specify the correct IP address, UNC path, or mapped 
path to the post office directory for the recipient's post office? 


No Correct the information. Restart the MTA. Observe the MTA agent console 
for any sign of problems. Repeat the test. 


Yes The link to recipient's post office is correct. Continue below. 


6 Ifyou are using client/server access to Post Office B, check the IP address and port displayed 
in the Network Address box of the POA Identification page. 


Are the IP address and TCP port number for the POA correct? 


No Correct the information. Restart the POA in Post Office B. Observe the POA 
agent console for any sign of problems. Repeat the test. 


Yes The IP address and port for the POA are correct. Continue below. 


7 Check rights for the MTA to write files into the post_office\wpcsout\ofs\6 directory in Post 
Office B. 


Are the network rights in the post office correct? 
No Reset the rights in the post office, and repeat the test. 
Yes Continue below. 
8 Check for available disk space in the post_office\wpcsout\ofs\6 directory in Post Office B. 


Is there adequate disk space available in the post office? 


No Remove unnecessary files from the server to free up disk space, then repeat the 
test. 
Yes Continue below. 


9 If these troubleshooting steps have not enabled the MTA to write the file into the 
post_office\wpcsout\ofs\6 directory in the recipient's post office, see Novell Support (http:// 
support.novell.com). 
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Message Does Not Arrive between Domains 


Problem: 


Action: 


Action: 


A message from a user in Domain A is not being delivered to a user in Domain B. 


Review the stages of message flow between domains. See “Message Delivery to a Different 
Domain” in GroupWise 6.5 Troubleshooting 3: Message Flow and Directory Structure. 


Answer the question below: 


Can other users in Domain A send messages to other users in Domain B? 


Yes See “Problem with an Individual User in Either Domain” on page 67. 
No See “Problem between Domains for Multiple Users” on page 70 
Don’t Know See “Problem between Domains for Multiple Users” on page 70 


Problem with an Individual User in Either Domain 
1 Stop the MTA for Domain A. 


2 Have the user in Domain A send a low priority test message to a recipient in Domain B. (It's 
a good idea to test message flow using a low priority message because the low priority 
message queue is typically empty.) 


3 Check the post_office\wpcsin\6 directory in the sender's post office. 


Has a new message file appeared in the post_office\wpcsin\6 directory? 


No The GroupWise client was unable to create the message files. The user might 


not have sufficient rights to the directory. Correct the problem, then repeat the 
test. 
Yes The sender can successfully send messages. Continue below. 


4 Stop the POA for the recipient's post office in Domain B. 
5 Start the MTA for Domain A.Observe the MTA agent console for any sign of problems. 
6 Check the domain\wpcsin\6 directory in Domain B. 


Has a new message file appeared in the domain\wpcsin\6 directory? 


No The message is not transferring between domains. See “Problem between 
Domains for Multiple Users” on page 70. 


Yes The message transferred successfully between domains. Continue below. 


7 Restart the POA for the recipient's post office in Domain B. Observe the POA agent console 
for any sign of problems. 


8 Recheck the post_office\wpcsout\ofs\6 directory in the recipient's post office in Domain B. 


Has the message file disappeared from the post_office\wpcsout\ofs\6 directory? 


No The POA was unable to pick up the message. Correct the problem, then 
repeat the test. 
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Has the message file disappeared from the post_office\wpcsout\ofs\6 directory? 


Yes The POA has successfully picked up the message. Continue below. 


9 Check the recipient's mailbox. 


Does the new message appear in the recipient’s mailbox? 


Yes The POA has successfully delivered the message this time. Repeat the test 


with a different user. 
No The POA was unable to deliver the message. Continue below. 


10 Check the ownership of the recipient's user database (userxxx.db). 


Does the ownership of the user database match the recipient's network login ID? 


No Reset the ownership on the user database, then repeat the test. 


Yes Continue below. 


11 Check the ownership of the message database (msgvn.db) in the recipient's post office that 
corresponds to the message database assigned to the sender in the sender's post office. 


Is the ownership of the message database correct? 


No Reset the ownership on the message database, then repeat the test. 


Yes Continue below. 


12 In ConsoleOne, perform maintenance to correct any problems with the databases. See 


“Maintaining User/Resource and Message Databases” in “Databases” in the GroupWise 6.5 
Administration Guide. Then repeat the test. 


13 Ifthe message flow problem has not been resolved by following the above troubleshooting 
steps, see Novell Support (http://support.novell.com). 


Problem between Domains for Multiple Users 


1 Stop the MTA for Domain A. 


2 Have the user in Domain A send a low priority test message. (It's a good idea to test message 
flow using a low priority message because the low priority message queue is typically empty.) 


3 Check the post_office\wpcsin\6 directory in the sender's post office. 


Has a new message file appeared in the post_office\wpcsin\6 directory? 


No See “Problem with an Individual User in Either Domain” on page 67. 


Yes The sender can successfully send messages. Continue below. 


4 Stop the POA and the MTA for Domain B. 


5 Restart the MTA for Domain A. Observe the MTA agent console for any sign of problems. 
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6 Check the domain\wpcsin\6 directory in Domain B. 


Has a new message file appeared in the domain\wpcsin\6 directory? 
No See “Problem with Access to Domain B” on page 71. 


Yes The file has successfully transferred to Domain B. Continue below. 


7 Restart the MTA for Domain B. Observe the MTA agent console for any sign of problems. 
8 Check the post_office\wpcsout\ofs\6 directory in the recipient's post office. 


Has a new message file appeared in the post_office\wpcsout\ofs\6? 
No See “Problem with Access to the Post Office in Domain B” on page 73. 


Yes The MTA has successfully transferred the file to the POA in the recipient's 
post office. Continue below. 


9 Restart the POA for the recipient's post office in Domain B. Observe the POA agent console 
for any sign of problems. 


10 Recheck the post_office\wpcsout\ofs\6 directory in the recipient's post office. 


Has the message file disappeared from the post_office\wpcsout\ofs\6 directory? 


No The message transferred successfully between domains and into the recipient's 
post office, but the POA in the recipient's post office is unable to pick up the file. See 
Step 8 in “Problem with an Individual User in Either Domain” on page 67. 


Yes The message transferred successfully between domains and into the recipient's 
post office, and the POA in the recipient's post office has picked up the file. If the 
message still does not arrive in the recipient's mailbox, see Step 8 through Step 13 
in “Problem with an Individual User in Either Domain” on page 67. 


Problem with Access to Domain B 
1 Start ConsoleOne with read/write rights to the domain. 
2 Open the browser window. 
3 Double-click the eDirectory container where Domain A is located, then select Domain A. 
4 Click Tools > GroupWise Utilities > Link Configuration. 
5 Check the link from Domain A to Domain B. Answer the following question: 
Does the link from Domain A specify the correct IP address, UNC path, or mapped path to the domain 


directory for Domain B? 


No Correct the information. Restart the MTA in Domain A. Observe the MTA 
agent console for any sign of problems. Repeat the test. 


Yes The link to Domain B is correct. Continue below. 
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6 Ifyou are using TCP/IP links between domains, check the IP address and port displayed in 
the Network Address box of the MTA Identification page. See “Using TCP/IP Links between 
Domains” in “Message Transfer Agent” in the GroupWise 6.5 Administration Guide. 


Are the IP address and TCP port number for the MTA correct? 


No Correct the information. Restart the MTA. Observe the MTA agent console for 
any sign of problems. Repeat the test. 


Yes The IP address and port for MTA are correct. Continue below. 


7 Ifyou are using mapped or UNC links, check rights for the Domain A MTA to write files into 
the domain\wpcsin\6 directory in Domain B. 


Are the network rights in the domain correct? 
No Reset the rights in Domain B, and repeat the test. 
Yes Continue below. 
8 Check for available disk space in the domain\wpcsin\6 directory in Domain B. 


Is there adequate disk space available in the domain? 


No Remove unnecessary files from the server to free up disk space, then repeat 
the test. 
Yes Continue below. 


9 If these troubleshooting steps have not enabled the Domain A MTA to write the file into the 
domain\wpcsin\6 directory in Domain B, see Novell Technical Support (http:// 
support.novell.com). 


Problem with Access to the Post Office in Domain B 
1 Start ConsoleOne with read/write rights to the post office. 
2 Open the browser window. 
3 Double-click the eDirectory container where Domain B is located, then select Domain B. 
4 Click Tools > GroupWise Utilities > Link Configuration. 
5 Check the link from Domain B to the recipient's post office. 


Does the link from the domain to the post office specify the correct IP address, UNC path, or mapped 
path to the post office directory for the recipient's post office? 


No Correct the information. Restart the MTA in Domain B. Observe the MTA 
agent console for any sign of problems. Repeat the test. 


Yes The link to recipient's post office is correct. Continue below. 


6 Ifyou are using a TCP/IP link to the post office, check the IP address displayed in the Network 
Address box of the POA Identification page. 
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Is the IP address and TCP port number for the POA correct? 


No Correct the information. Restart the POA. Observe the POA agent console for 
any sign of problems. Repeat the test. 


Yes The IP address and TCP port number for the POA is correct. Continue below. 


7 Ifyou are using a mapped or UNC link to the post office, check rights for the Domain BMTA 
to write files into the post_office\wpcsout\ofs\6 directory in the post office. 


Are the network rights for the post office correct? 
No Reset the rights in the post office, and repeat the test. 


Yes Continue below. 


8 Check for available disk space in the post_office\wpcsout\ofs\6 directory in the recipient's 
post office. 


Is there adequate disk space available in the post office? 


No Remove unnecessary files from the server to free up disk space, then repeat 
the test. 
Yes Continue below. 


9 If these troubleshooting steps have not enabled the Domain B MTA to write the file into the 
post_office\wpcsout\ofs\6 directory in the recipient's post office, see Novell Support (http:// 
support.novell.com). 


Message Does Not Arrive Across the Internet 


Problem: 


Action: 


Action: 


A message is not successfully delivered between a Group Wise user and an e-mail user somewhere 
on the Internet. 


Review the stages of message flow performed by the Internet to send and receive messages across 
the Internet. See “Message Delivery to and from the Internet” in “Message Flow Diagrams” in 
GroupWise 6.5 Troubleshooting 3: Message Flow and Directory Structure. 


The most useful procedure to find the source of a problem when a message is not being sent across 
the Internet is to break the GroupWise send process into steps and verify that the message arrives 
at each destination before the next piece receives and delivers it. 


If a message has Pending status in the sender’s Sent Items folder, the message is somewhere in the 
Group Wise system. 


A message has Pending status in the sender’s Sent Items folder until it is converted and queued to 
the SMTP service. The message has Transferred status after the Internet Agent queues the message 
to the SMTP service. If the Internet Agnet is unsuccessful in sending the message and gets a 
temporary error (for example, Host Down), it will attempt to send the message according to the 
Retry Schedule. During this time, the message has Pending status in the sender’s Sent Items folder. 
If the Internet Agent is ultimately unsuccessful in sending the message, the sender receives an 
undeliverable status. 
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The following steps provide general guidelines for checking the message at each point in the 
GroupWise system: 


1 Stop the Internet Agent and the Message Transfer Agent. Send a message from GroupWise, 


then look in the \vost_office_a\wpcsin\0-7 directory for a file where the client transfers the 


message. If the file exists, verify the time and date stamp of the file and continue with Step 2. 


If the file does not exist, the client did not transfer the file into the \wpcsin\0-7 directory. 


Verify the address of the message and send another message to someone else on the Internet. 


2 If the file does exist in the \post_office_a\wpcsin\0-7 directory, then start the Message 
Transfer Agent. The Message Transfer Agent polls the \wpcsin\0-7 directory and places the 
message in the wpgate\gwia\wpcsout\gwixxxx\0-7 directory. (gwixxxx is a random directory 
name generated from information from ConsoleOne.) If the file exists, continue to Step 3. 


If the file does not exist in the wpcsout\gwixxxx\0-7 directory, then the Message Transfer 


Agent is not processing the files. See “Message Transfer Agent Problems” on page 31. After 


the MTA is working correctly, return to Step 1. 


3 After the file is in the \gwixxxx\0-7 directory, start the Internet Agent. The file should transfer 


to the wpgate\gwia\send directory. If the file exists in the send directory, continue to Step 4. 


If the file does not exist in the \send directory, then the error is written to the log file. Look at 
the log file in the wpgate\gwia\000.pre directory. Files sent from GroupWise that have been 
corrupted are transferred to the wpcsout\problem directory. Change the log level to Diag, then 


repeat Step | through Step 3. 
4 After the file is delivered to the send directory, exit the Internet Agent. 


While the Internet Agent is delivering a message, it builds a file in the 
domain\wpgate\gwia\result directory. As soon as it delivers the entire message, check the 
result directory. 


If the file does not exist in the result directory, then the Internet Agent is not working. Check 


the /dhome and /home switches to ensure they are pointing to the correct directories. 


If the file does exist in the result directory, check the TCP configuration or read the file and 


notice the last part of the message that was sent. You should have a file that contains several 


lines of comments preceded by 250 (OK reply). 


5 If an Internet host is down or the connection is not made on the Internet, start the Internet 
Agent to place the message in the wpgate\gwia\defer directory for 20 minutes. The Internet 


Agent transfers the file to the send directory for another attempt at sending to the Internet. The 


Internet Agent defers and re-queues the message according to the Retry Schedule. The 


Internet Agent makes this attempt three times in one hour and then every four hours for four 


days. After the four days, if the Internet host remains down, an undeliverable status is sent 
back to the sender. 


6 If the file in the result directory does not indicate an error, start the Internet Agent again and 
see if SMTP sends a message back to the sender’s post office. In the Client Sent Items folder, 


check the message properties for the message status. At this point, an undeliverable status 
indicates an incorrect Internet address. 


7 Messages sent from GroupWise with a Delayed Delivery status do not go to the send 


directory. Instead they reside in the wpgate\gwia\gwhold directory until the date the message 


should be sent. 


8 Ifan Internet user receives an undeliverable message because of an incorrect address to a 


Groupwise user, a copy of the message from the Internet resides in the wpgate\gwia\gwprob 


directory. 
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Message Delivery Is Slow 


Select the configuration where message flow is slow: 
“Message Delivery Is Slow in the Local Post Office” on page 79 
+ “Message Delivery Is Slow between Post Offices” on page 80 


+ “Message Delivery Is Slow between Domains” on page 81 


Message Delivery Is Slow in the Local Post Office 


Problem: 


Action: 


Possible Cause: 


Action: 


Possible Cause: 


Action: 


Action: 


Message delivery between GroupWise” users in the same post office is slower than desired. 


Review the stages of message flow within the local post office. See “Message Delivery in the 
Local Post Office” in GroupWise 6.5 Troubleshooting 3: Message Flow and Directory Structure. 


The POA has been installed on a server with insufficient system resources. 


Check the utilization and memory on the server where the POA is running to see if other programs 
are taking more resources than usual. If the POA has fewer resources than usual, it can take longer 
to deliver messages. Make sure the server still meets the system requirements for running the POA. 
See “Agent System Requirements” in “Installing GroupWise Agents” in the GroupWise 6.5 
Installation Guide. 


The POA is not configured optimally. 


Go to the server where the POA is running. Check the POA agent console to see how busy the 
POA is. If the POA is very busy, it can take longer to deliver messages. If the POA needs to handle 
the current load on a permanent basis, see “Optimizing the POA” in “Post Office Agent” in the 
GroupWise 6.5 Administration Guide. 


TCP/IP links between the GroupWise client and the post office can be faster than mapped drive 
connections. If you are currently using mapped drive connections and have TCP/IP available, you 
could change the configuration of the client and POA to use TCP/IP links instead. See “Using 
Client/Server Access to the Post Office”in “Post Office Agent” in the GroupWise 6.5 
Administration Guide. 


Message Delivery Is Slow between Post Offices 


Problem: 


Action: 


Action: 


Possible Cause: 


Message delivery between GroupWise users in different post offices in the same domain is slower 
than desired. 


Review the stages of message flow between post offices. See “Message Delivery to a Different 
Post Office” in GroupWise 6.5 Troubleshooting 3: Message Flow and Directory Structure. 


If message delivery between users in the same post office is also slower than desired, see “Message 
Delivery Is Slow in the Local Post Office” on page 79. Resolve problems in local post offices first 
before troubleshooting problems between post offices. 


The MTA has been installed on a server with insufficient system resources. 
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Action: 


Possible Cause: 


Action: 


Possible Cause: 


Action: 


Possible Cause: 


Action: 


Check the utilization and memory on the server where the MTA is running to see if other programs 
are taking more resources than usual. If the MTA has fewer resources than usual, it can take longer 
to deliver messages between post offices. Make sure the server still meets the system requirements 
for running the MTA. See “Agent System Requirements” in “Installing GroupWise Agents” in the 
GroupWise 6.5 Installation Guide. 


The MTA is not configured optimally. 


Go to the server where the MTA is running. Check the MTA agent console to see how busy the 
MTA is. If the MTA is very busy, it can take longer to deliver messages between post offices. If 
the MTA needs to handle the current load on a permanent basis, see “Optimizing the MTA” in 
“Message Transfer Agent” in the GroupWise 6.5 Administration Guide. 


The network itself is busy. 


Check network traffic between the servers where the POA and MTA are running. Heavy network 
traffic can slow down the transfer of GroupWise messages between post offices. 


If the MTA has received a large number of administrative messages, user messages might be 
delayed because administrative messages are of higher priority. 


Check the MTA log file to see what types of messages the MTA is currently processing. See 
“Using MTA Log Files” in “Message Transfer Agent” in the GroupWise 6.5 Administration 
Guide. After high priority administrative messages are processed, user messages will be 
processed. 


Message Delivery Is Slow between Domains 


Explanation: 


Action: 


Action: 


Action: 


Possible Cause: 


Action: 


Possible Cause: 


Action: 


Possible Cause: 


Action: 


Message delivery between GroupWise users in different domains is slower than desired. 


Review the stages of message flow between domains. See “Message Delivery to a Different 
Domain” in GroupWise 6.5 Troubleshooting 3: Message Flow and Directory Structure. 


If message delivery between users in the same post office is also slower than desired, see “Message 
Delivery Is Slow in the Local Post Office” on page 79. Resolve problems in local post offices first 
before troubleshooting problems between post offices or domains. 


If message delivery between users in different post offices in the same domain is also slower than 
desired, see “Message Delivery Is Slow between Post Offices” on page 80. Resolve problems 
between post offices before troubleshooting problems between domains. 


The MTA has been installed on a server with insufficient system resources. 


Check the utilization and memory on the server where the MTA is running to see if other programs 
are taking more resources than usual. If the MTA has fewer resources than usual, it can take longer 
to deliver messages between domains. Make sure the server still meets the system requirements 
for running the MTA. See “Agent System Requirements” in “Installing GroupWise Agents” in the 
GroupWise 6.5 Installation Guide. 


The MTA is not configured optimally. 


Go to the server where the MTA is running. Check the MTA agent console to see how busy the 
MTA is. If the MTA is very busy, it can take longer to deliver messages between domains. If the 
MTA needs to handle the current load on a permanent basis, see “Optimizing the MTA” in 
“Message Transfer Agent” in the GroupWise 6.5 Administration Guide. 


The network itself is busy. 


Check network traffic between the servers where the POA and MTA are running. Heavy network 
traffic can slow down the transfer of GroupWise messages between domains. Also check general 
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Possible Cause: 


Action: 


network configuration, looking for slow links, congested hubs, and busy subnets that lie along the 
route GroupWise messages must take between domains. 


Links between domains are not configured optimally. 


Check the number of hops the message must travel between domains. You can view this 
information for a message in the mailbox of a user who has problems with slow message delivery. 
If messages are being routed through a large number of domains, use the Link Configuration Tool 
in ConsoleOne® to design a more efficient route for messages between domains. See 
“Understanding Link Configuration” in “Domains” in the GroupWise 6.5 Administration Guide. 
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Message Has Undeliverable Status 


Select the configuration where undeliverable messages are occurring: 
+ “Message Has Undeliverable Status in the Local Post Office” on page 83 
+ “Message Has Undeliverable Status between Post Offices” on page 84 


e “Message Has Undeliverable Status between Domains” on page 85 


Message Has Undeliverable Status in the Local Post Office 


Problem: 


Explanation: 


Possible Cause: 


Action: 


Possible Cause: 


Action: 


Possible Cause: 


Action: 
Possible Cause: 


Action: 


A user sends a message to another user in the same post office, and the message comes back with 
a status of Undeliverable. 


A status of Undeliverable indicates the user to whom the message is addressed does not exist in 
the post office. 


The sender manually typed the recipient's address, rather than selecting it in the GroupWise® 
Address Book, and typed it incorrectly. 


Have the sender select the recipient in the GroupWise Address Book so the address is provided 
automatically, then resend the message. 


If the sender is selecting a group, rather than an individual recipient, from the GroupWise Address 
Book, the group could be out of date if the recipient's user ID has changed. 


Re-create the group by selecting each individual user from the Address Book to make sure current 
user IDs are included in the group. 


If the recipient is a brand new user, the sender might have sent the message before the recipient 
was actually created in the post office. 


Verify the existence of the user in the post office before the sender tries to send the message again. 
The recipient's mailbox might be damaged so the message cannot be delivered. 


In ConsoleOne®, perform maintenance to correct any problems with the recipient's mailbox. See 
“Maintaining User/Resource and Message Databases” in “Databases” in the GroupWise 6.5 
Administration Guide. 


Message Has Undeliverable Status between Post Offices 


Problem: 


Explanation: 


Possible Cause: 


A user sends a message to a recipient in a different post office, and the message comes back with 
a status of Undeliverable. 


A status of Undeliverable indicates either that the user to whom the message is addressed does not 
exist in the post office, or that the post office does not exist in the domain. 


The sender manually typed the recipient's address, rather than selecting it in the GroupWise 
Address Book, and typed it incorrectly. 
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Action: 


Possible Cause: 


Action: 


Possible Cause: 


Action: 
Possible Cause: 


Action: 


Problem: 


Explanation: 


Possible Cause: 


Action: 


Possible Cause: 


Action: 
Possible Cause: 


Action: 


Possible Cause: 


Action: 


Possible Cause: 
Action: 


Possible Cause: 


Action: 


Possible Cause: 


Have the sender select the recipient in the GroupWise Address Book so the address is provided 
automatically, then resend the message. 


If the sender is selecting a group, rather than an individual recipient, from the GroupWise Address 
Book, the group could be out of date if the recipient's user ID or post office has changed. 


Re-create the group by selecting each individual user from the Address Book to make sure current 
user IDs and post offices are included in the group. 


If the recipient is a new user, the sender might have sent the message before the recipient was 
actually created in the post office. 


Verify the existence of the user in the post office before the sender tries to send the message again. 
The recipient's mailbox might be damaged so the message cannot be delivered. 


In ConsoleOne perform maintenance to correct any problems with the recipient's mailbox. See 
“Maintaining User/Resource and Message Databases” in “Databases” in the GroupWise 6.5 
Administration Guide. 


Message Has Undeliverable Status between Domains 


A user sends a message to a recipient in a different domain, and the message comes back with a 
status of Undeliverable. 


A status of Undeliverable indicates either the user to whom the message is addressed does not exist 
in the post office, or the post office does not exist in the domain, or that the domain does not exist 
in the GroupWise system. 


If the sender is selecting a group, rather than an individual recipient, from the GroupWise Address 
Book, the group could be out of date if the recipient's user ID or post office has changed. 


Re-create the group by selecting each individual user from the Address Book to make sure current 
user IDs and post offices are included in the group. 


If the recipient is a new user, the sender might have sent the message before the recipient was 
actually created in the post office. 


Verify the existence of the user in the post office before the sender tries to send the message again. 
The recipient's mailbox might be damaged so the message cannot be delivered. 


In ConsoleOne, perform maintenance to correct any problems with the recipient's mailbox. See 
“Maintaining User/Resource and Message Databases” in “Databases” in the GroupWise 6.5 
Administration Guide. 


If the sender is selecting a group, rather than an individual recipient, from the GroupWise Address 
Book, the group could be out of date if the recipient's user ID, post office, or domain has changed. 


Re-create the group by selecting each individual user from the Address Book to make sure current 
user IDs, post offices, and domains are included in the group. 


The sender is mailing to a user in an external GroupWise system and has an incorrect address. 
Have the sender verify the address with the recipient, then send the message again. 


If the recipient is a brand new user, the sender might have sent the message before the recipient 
was actually created in the post office. 


Verify the existence of the user in the post office before the sender tries to send the message again. 


The recipient's mailbox might be damaged so the message cannot be delivered. 
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Action: In ConsoleOne, perform maintenance to correct any problems with the recipient's mailbox. See 
“Maintaining User/Resource and Message Databases” in “Databases” in the GroupWise 6.5 
Administration Guide. 


Possible Cause: Links between domains and post offices are not set up correctly. 


Action: Check the link configuration in ConsoleOne to make sure links between domains and post offices 
are set up correctly. See “Understanding Link Configuration” in “Domains” in the GroupWise 6.5 
Administration Guide. 
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Message Is Dropped in the problem Directory 


Select the location of the problem directory: 
+ “Message Is Dropped in the problem Directory in the Post Office” on page 87 
+ “Message Is Dropped in the problem Directory in the Domain” on page 88 


Message Is Dropped in the problem Directory in the Post Office 


Problem: 


Explanation: 


Action: 


Action: 


Action: 


In the Statistics box in an agent console, you notice that some problem messages or message errors 
have been encountered. 


Problem messages are message files that cannot be processed by the agents for a variety of reasons. 
Each file has an extension that indicates which agent (POA or MTA) placed the file in the 
post_office\wpcsout\problem directory. 


If Group Wise® is currently set up to mail problem messages to the GroupWise administrator, 
check the mailbox of the GroupWise administrator for messages with problem message files 
attached. Follow the instructions in the message for handling the problem files. 


Sometimes a problem file can be handled successfully if requeued. Place the file into the proper 
priority 0 subdirectory, as indicated by the extension on the message file. Placing it in the 0 
subdirectory gives it high priority for reprocessing. If conditions have changed on the network, the 
message might be able to be processed. 


If the message still cannot be processed after being requeued, it has been damaged in some way 
that makes it unreadable. This should happen only very rarely. 


If your Group Wise system reports a large number of problem messages, you should determine 
what is causing the damage. See Novell® Support (http://support.novell.com). 


Message Is Dropped in the problem Directory in the Domain 


Problem: 


Explanation: 


Action: 


Possible Cause: 


Action: 


Action: 


In the Statistics box in an agent console, you notice that some problem messages or message errors 
have been encountered. 


Problem messages are message files that cannot be processed by the agents for a variety of reasons. 
Therefore, they are placed in the domain\wpcsout\problem directory. 


If Group Wise is currently set up to mail problem messages to the GroupWise administrator, check 
the mailbox of the GroupWise administrator for messages with problem message files attached. 
Follow the instructions in the message for handling the problem files. 


Files placed in the problem directory in the domain have been damaged in some way that makes 
them unreadable. 


None. This should happen only very rarely. 


If your Group Wise system reports a large number of problem messages, you should determine 
what is causing the damage. See Novell Support (http://support.novell.com). 
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Strategies for Administration Problems 


This part of Troubleshooting 2: Solutions to Common Problems helps you resolve problems 
running the Group Wise® Administrator snap-in to ConsoleOne® and problems managing 
GroupWise Document Management Services (DMS). 


+ “GroupWise Administrator Snap-In to ConsoleOne Problems” on page 81 


+ “Document Management Services Problems” on page 85 


Other sources of assistance include: 
+ Novell Support (http://support.novell.com) 
+ Novell® Support Knowledgebase (http://support.novell.com/search/kb_index.jsp) 
+ GroupWise 6.x Support Forums (http://support.novell.com/forums/2gw.html) 


+ GroupWise Cool Solutions (http://www.novell.com/coolsolutions/gwmag/index.html) 


Strategies for Administration Problems 
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GroupWise Administrator Snap-In to ConsoleOne Problems 


+ GroupWise 6.5 Troubleshooting 1: Error Messages in GroupWise 6.5 Troubleshooting 1: 
Error Messages 


+ “ConsoleOne Can't Access the Domain Database” on page 81 

+ “You Aren't Connected to the Right GroupWise Domain” on page 82 
+ “You Can't Create or Delete GroupWise Objects” on page 82 

+ “Pending Operations Aren't Completed” on page 82 

+ “Creation of a Secondary Domain Isn't Completed” on page 82 

¢ “Addressing Rules Aren't Working” on page 83 

¢ “Synchronization Isn't Working” on page 83 

+ “You Can't Move a User” on page 83 

+ “NDS Objects Aren't Linking to GroupWise Objects” on page 83 


ConsoleOne Can't Access the Domain Database 


Problem: 


Possible Cause: 


Action: 


Possible Cause: 


Action: 


Possible Cause: 
Action: 
Possible Cause: 


Action: 


Possible Cause: 


You run ConsoleOne® but cannot access the domain where you need to make changes. 


You have not yet authenticated to an eDirectory™ tree. On Linux, ConsoleOne does not 
authenticate automatically, nor does it automatically connect to the same domain database you 
were connected to during the previous ConsoleOne session. 


Manually authenticate and connect. 

1 In ConsoleOne, select NDS, then click File > Authenticate. 

2 Provide the required authentication information, then click Login. 

3 Browse to and select a domain, then click Tools > GroupWise System Operations > Connect. 
You are not connected to the correct domain. 


Make sure you are connected to the correct domain. See “Connecting to a Domain” in “Domains” 
in the GroupWise 6.5 Administration Guide. 


You don’t have sufficient rights. 
Make sure you started ConsoleOne with sufficient rights to modify the Domain object. 
The domain database (wpdomain.db) is damaged. 


Rebuild the domain database. See “Rebuilding Domain or Post Office Databases” in “Databases” 
in the GroupWise 6.5 Administration Guide. 


The domain database (wpdomain.db) is locked. Because ConsoleOne is designed to allow multiple 
administrators to access databases simultaneously, this theoretically should not happen, but 
occasionally it does. 


GroupWise Administrator Snap-In to ConsoleOne Problems 81 


Action: 


Exit ConsoleOne and restart. 


You Aren't Connected to the Right GroupWise Domain 


Problem: 


Action: 


You are attempting to modify a GroupWise® object in ConsoleOne. A message informs you that 
you cannot perform the action because you are not connected to the correct GroupWise domain. 


Connect to the correct GroupWise domain. See “Connecting to a Domain” in “Domains” in the 
GroupWise 6.5 Administration Guide. 


You Can't Create or Delete GroupWise Objects 


Problem: 


Possible Cause: 


Action: 


Possible Cause: 
Action: 
Possible Cause: 


Action: 


You are running ConsoleOne to create or delete a GroupWise object. However, you are unable to 
perform the action. 


You are not connected to the correct domain. 


Make sure you are connected to the correct domain. See “Connecting to a Domain” in “Domains” 
in the GroupWise 6.5 Administration Guide. 


You do not have sufficient eDirectory rights. 
Make sure you started ConsoleOne with sufficient rights to the Group Wise object. 
You do not have sufficient file system rights. 


Make sure you have sufficient rights to the directory structure associated with the GroupWise 
domain or post office. See “GroupWise Administrator Rights” in “Security” in the Group Wise 6.5 
Administration Guide. 


Pending Operations Aren't Completed 


Problem: 


Action: 


Action: 


Possible Cause: 


Action: 


You have performed some actions on GroupWise objects in ConsoleOne. You see them listed in 
the Pending Operations dialog box, but they are not completed. 


Use the Retry option or the Undo option in the Pending Operations dialog box. See “Pending 
Operations” in “System” in the GroupWise 6.5 Administration Guide. 


Check the MTA log files to see if the administrative message has been delivered. See “Using MTA 
Log Files” in “Message Transfer Agent” in the GroupWise 6.5 Administration Guide. 


The MTA is not running. 


Make sure that the MTA is running and that no post offices or domains are closed. See “Monitoring 
the MTA” in “Message Transfer Agent” the GroupWise 6.5 Administration Guide. 


Creation of a Secondary Domain Isn't Completed 


Problem: 


Action: 


You are creating a secondary domain, but the process is interrupted before completion. For 
example, you click Cancel, or a power failure or hardware failure occurs. The result is that the new 
secondary domain appears in the GroupWise view but does not appear in the eDirectory tree. 


First, graft the new secondary domain into the eDirectory tree. See “GW / eDirectory Association” 
in “System” in the GroupWise 6.5 Administration Guide. Next, select the secondary domain in the 
eDirectory tree, then rebuild it. See “Rebuilding Domain or Post Office Databases” in “Databases” 
in the GroupWise 6.5 Administration Guide. 
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Addressing Rules Aren't Working 


Problem: 
Possible Cause: 


Action: 


Possible Cause: 


Action: 


You created an addressing rule; however, it isn't working for users in the GroupWise client. 
You didn’t enable the addressing rules after creating them. 


Addressing rules must be enabled after being created. See “Addressing Rules” in “System” in the 
GroupWise 6.5 Administration Guide. 


The addressing rules haven’t replicated to the user’s post office. 


Rebuild the post office database (wphost.db). See “Rebuilding Domain or Post Office Databases” 
in “Databases” in the GroupWise 6.5 Administration Guide. 


Synchronization Isn't Working 


Problem: 


Action: 


The MTA automatically synchronizes information throughout your Group Wise system. However, 
you notice that some Group Wise information is not being synchronized. 


Manually synchronize the information in ConsoleOne. See “Synchronizing Database 
Information” in “Databases” in the GroupWise 6.5 Administration Guide. 


You Can't Move a User 


Problem: 


Possible Cause: 


Action: 


Possible Cause: 


Action: 


Possible Cause: 
Action: 
Possible Cause: 


Action: 


You attempt to move a user from one post office to another, but the user does not appear in the 
destination post office. 


The agents aren’t functioning properly. 


Make sure the MTA and POA are configured correctly and are running. See “Message Transfer 
Agent” and “Post Office Agent” in the GroupWise 6.5 Administration Guide. 


The move hasn’t been completed yet. 


If you are moving a user from one domain to another, view the pending operations to see if the 
operation is complete. See “Pending Operations” in “System” in the GroupWise 6.5 
Administration Guide. You can also use the Move User Status utility to watch the progress of user 
moves. See “Monitoring User Move Status” in “Users” in the GroupWise 6.5 Administration 
Guide. 


The move failed. 
Check the MTA and POA log files to see if the process failed. If so, repeat the move. 
There is insufficient disk space in the destination post office. 


Verify the post office to which you are moving the user has sufficient free disk space. 


NDS Objects Aren't Linking to GroupWise Objects 


Problem: 


Action: 


In ConsoleOne, eDirectory objects are not linking successfully to Group Wise objects. 


Record the conditions under which you encountered the problem. For technical services, see 
Novell® Support (http://support.novell.com). 
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Document Management Services Problems 


If these troubleshooting strategies do not solve the problem, see Novell® Support (http:// 
support.novell.com). 


+ “Documents Are Not Listed in User's Folder” on page 85 

+ “User Can't Exit GroupWise Because a Document Isn't Closed” on page 85 
+ “GroupWise Can't Monitor a Non-Integrated Application” on page 85 

+ “User Wants to Turn Off Integrations Temporarily” on page 86 

e “Administrator Wants to Remove Integrations Permanently” on page 86 

e “Administrator Wants to Add a Custom Integration” on page 87 


¢ “Administrator Wants to Distribute Standardized Integrations” on page 87 


Documents Are Not Listed in User's Folder 


Problem: 


Action: 


A user creates or imports a document in the Group Wise® Windows client. The document does not 
appear in the folder where the user expects to find it. 


On the GroupWise client toolbar, click Show Personal Items. Documents are considered personal 
items and are not listed when personal items are filtered out. 


User Can't Exit GroupWise Because a Document Isn't Closed 


Problem: 


Action: 


Action: 


A user edits a document in a non-integrated application. The user has exited the application. 
However, when the user tries to exit the GroupWise Windows client, the client indicates that a 
document is still open or has not been returned to the Group Wise library. 


Click Yes in the error dialog box to let GroupWise attempt to return the document to the 
Group Wise library. 


Locate the open document and make sure it is closed properly. Look in the Work in Progress folder 
for open documents. 


GroupWise Can't Monitor a Non-Integrated Application 


Problem: 


Explanation: 


Possible Cause: 


The user edits a document and the Group Wise Windows client indicates the application cannot be 
monitored. Therefore, the user must return the document to the GroupWise library manually. 


The manner in which the GroupWise client monitors applications can be modified using settings 
in the gwappint.inf file, located in the \windows\system directory. This file contains information 
about integrating applications and monitoring non-integrated applications that are started from the 
Group Wise client. 


Some applications, such as WordPerfect* 7.0 and Lotus* Word Pro 96, are integrated through 
ODMA. Other applications, such as Microsoft* Word 7.0 and Excel 7.0, are integrated through 
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Action: 


Action: 


Possible Cause: 


Action: 


Possible Cause: 


Action: 


Action: 


Action: 


application macros. If an integrated application is not set up correctly, it is handled as a non- 
integrated application. 


Normally, Setup detects an application is installed and then allows the user to choose whether or 
not to have integrations installed for that application. If the application setup didn't run correctly, 
the GroupWise client might not detect that the integration installed. If necessary, integrations can 
be installed manually. 


For ODMA applications, the gwappint.inf file needs to contain an Integrations=2 entry for 
the application. In addition, the following DLL programs are copied to the \windows\system 
directory when Setup is run: odma32.dll, gwodm132.dll, and gwodm1xx.dll. The name of the 
gwodm1xx.dll depends on which language was selected when Setup was run. 


For applications that use an integration macro, the gwappint.inf file needs to contains an 
Integrations=1 entry for the application. There should also be an integration macro installed 
in the application's macro startup directory. 


For non-integrated applications, the Group Wise client attempts to monitor when an application 
terminates so open documents can be returned to the Group Wise library automatically. If the 
Group Wise client wasn't able to determine the information needed to monitor the application 
termination, the user is instructed to return documents manually. 


Return documents manually. Save and exit each document. In the GroupWise client, right-click 
each document reference, then click Actions > Reset Document Status. 


Some applications do not start quickly enough for the GroupWise client to detect that they have 
started. 


You can change the amount of time the GroupWise client allows for the application to start using 
the WaitInterval setting. 


If problems persists, you can turn off the message for the application. Use ShowMessage=0 in 
the gwappint.inf file to turn off the message. 


See the gwappint.inf file in the \windows\system directory for more information. 


User Wants to Turn Off Integrations Temporarily 


Problem: 


Action: 


The user wants to turn off application integrations so the GroupWise Windows client no longer 
performs document management functions when the application is used. However, the user wants 
to be able to turn integrations back on easily. 


You can turn off integration for all integrated applications. From the Tools menu in the GroupWise 
client, click Options > Documents, then deselect Enable Integration with Other Applications. This 
turns off all integrations. You cannot turn off integration for an individual application and leave 
other applications integrated. 


Administrator Wants to Remove Integrations Permanently 


&6 


Problem: 


Action: 


Action: 


The administrator wants to permanently turn off one or more application integrations so the 
GroupWise Windows client no longer performs document management functions. 


Have users rerun Group Wise client Setup and deselect integrated applications so they are no longer 
integrated when the client software is updated. Then the macro must be removed from the startup 
directories for Microsoft Word or Excel as described below. 


The administrator can edit the gwappint.inf file, located in the \windows\system directory, to 
remove the integration information. 
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¢ Integrations=2: If an application has the setting Integrations=2 for an ODMA- 
compliant application, you can change to Integrations=0 for no integration. 


+ Integrations=1:If an application has the setting Integrations=1, indicating it is 
integrated using a startup macro, you must change to Integrations=0 for no integration 
and delete the startup macro. For example, to remove integration for Word, you would need 
to delete the gwnormxx.dot macro from the Word startup directory. For Excel, you would need 
to delete the gwx195.xla macro from the xlstart directory and reset the Excel toolbars. 


Administrator Wants to Add a Custom Integration 


Problem: 


Explanation: 


Action: 


The administrator wants to integrate a new application with the GroupWise Windows client. 


Integrations are set up using the gwappint.inf file, located in the \windows\system directory. This 
file contains information about integrating applications started from the GroupWise client. It can 
be edited using an ASCII or ANSI text editor. 


To integrate a new application, create a new section in the gwappint.inf file by surrounding the 
name of the program with square brackets. For example, [WPWIN.EXE]. Use the following 
options to define the integration: 


+ Integrations=2: If the application is ODMA-compliant, specify Integrations=2. 


+ Integrations=1: If the application has its own macro language and you want to write a startup 
macro, use Integrations=1, followed by AppKey=application_name. Use the 
application to create the startup macro and place the startup macro in the application's startup 
directory. 


¢ DualExe: For some applications, the name of the file containing the actual application is 
different from what you type to start the application. For example, to start WordPerfect 6.1, 
you type WPWIN, but the WordPerfect 6.1 program is actually contained in a file named 
wpwin61.exe. For such applications, you use the name of the program that starts the 
application as the section heading. For example, [WPWIN.EXE]. Then you use DualExe to 
specify the name of the file that actually contains the application. For example, 
dualexe=wpwin61.exe. You would need to consult the application documentation or its 
installation directory to determine the filename to use with DualExe. 


Administrator Wants to Distribute Standardized Integrations 


Problem: 


Action: 


You have created a custom integration between a new application and the GroupWise Windows 
client. You want all GroupWise users to have access to this new integration. 


You can distribute copies of the updated gwappint.inf file for all users to place in their 
\windows\system directories. This file is not replaced when Setup is run; therefore, customizations 
are preserved through updates. 
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Strategies for Client Problems 


This part of Troubleshooting 2: Solutions to Common Problems helps you resolve problems users 
encounter when running the GroupWise® client or GroupWise Remote. 


+ “GroupWise Client Problems” on page 91 
+ “GroupWise Remote Problems” on page 97 
Other sources of assistance include: 
+ Novell Support (http://support.novell.com) 
+ Novell® Support Knowledgebase (http://support.novell.com/search/kb_index.jsp) 
+ GroupWise 6.x Support Forums (http://support.novell.com/forums/2gw.html) 


+ GroupWise Cool Solutions (http://www.novell.com/coolsolutions/gwmag/index.html) 


Strategies for Client Problems 89 


90 GroupWise 6.5 Troubleshooting 2: Solutions to Common Problems 


GroupWise Client Problems 


Most of these problems can occur in either the GroupWise® Windows client or the Cross-Platform 
client, and the same solutions are applicable to both. 


+ “User Can't Start the GroupWise Client” on page 91 
+ “User Receives an Error Message and Code” on page 92 
+ “User Forgets His or Her GroupWise Password” on page 92 


+ “User Isn't Notified of New Messages” on page 92 


+ “User Can't Access Archived Messages” on page 92 

+ “Wrong Date/Time Appears in Messages” on page 92 

¢ “Status Isn't Being Returned for Sent Messages” on page 93 

+ “User's Message Isn't Delivered” on page 93 

+ “Users Don't Appear in the Address Book or Appear Multiple Times” on page 93 
¢ “Screen Information Isn't Being Updated Immediately” on page 94 

+ “User Is Notified of a New Message But the Message Isn't Received” on page 94 


+ “User Experiences a Delay When Starting the Client or Using Certain Client Features” on 
page 94 


¢ “User Experiences a Delay When Viewing or Printing” on page 95 


User Can't Start the GroupWise Client 


Problem: 
Possible Cause: 


Action: 


Possible Cause: 


Action: 


Action: 


Action: 


Possible Cause: 


Action: 


A user can’t start the Group Wise client. 
The user doesn’t exist in the post office yet. 


Verify you’ ve added the user to a post office. See “Creating GroupWise Accounts” in “Users” in 
the GroupWise 6.5 Administration Guide. 


If using client/server access, the user’s TCP/IP information might be incorrect. 


Make sure the user's post office is set up for client/server access. See “Using Client/Server Access 
to the Post Office” in “Post Office Agent” in the GroupWise 6.5 Administration Guide. 


Set up a Group Wise name server. See “Simplifying Client/Server Access with a GroupWise Name 
Server” in “Post Office Agent” in the GroupWise 6.5 Administration Guide. 


Use the /ipa and /ipp client startup switches to provide the correct IP address and TCP port 
information. 


Multiple users have the same network ID. 


If users share the same network ID, but have different GroupWise user IDs, start the GroupWise 
client using the /@u client startup switch. 
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User Receives an Error Message and Code 


Explanation: 


Action: 


Action: 


Action: 


The user receives an error message and code while using the Group Wise client. 


See “Group Wise Engine Error Codes” in GroupWise 6.5 Troubleshooting 1: Error Messages. If 
the error code you received is not in the list provided, standard solutions are not yet available. 


Use the Search feature of the GroupWise online documentation to locate a GroupWise error code 
or message text. If the error you received is not found, standard solutions are not yet available. 


If you cannot locate the specific error message or the suggested actions do not resolve the problem, 
see “General Troubleshooting Strategies” on page 9. 


User Forgets His or Her GroupWise Password 


Problem: 


Action: 


The user places a password on his or her GroupWise mailbox, then later forgets it. 


Use ConsoleOne® to reset the user's password. See “Creating or Changing a Mailbox Password” 
in “Users” in the GroupWise 6.5 Administration Guide. Then notify the user of the new password. 


User Isn't Notified of New Messages 


Problem: 
Possible Cause: 


Action: 


Possible Cause: 


Action: 


The user does not receive notifications when new GroupWise messages arrive. 
The user hasn’t turned on the Notify feature yet. 


Make sure Notify is turned on in the user's GroupWise Windows client and the user is subscribed 
to Notify. See “Running Notify” in “Managing Your Mailbox” in the GroupWise 6.5 Windows 
Client User Guide. 


Notify isn’t running on the user’s Windows workstation. 


Make sure Notify is running for the user. By default, Notify is added to the user's Startup group 
when Group Wise Setup runs, but the user might have removed it. Ifnecessary, rerun Setup to place 
Notify in the user's Startup group. 


User Can't Access Archived Messages 


Explanation: 


Possible Cause: 


Action: 


Possible Cause: 


Action: 


The user has archived GroupWise messages onto the hard disk of his or her computer. Later, the 
user cannot access the archived messages. 


The user doesn’t have an archive path set or has an invalid archive path set. 


Verify that the archive path specified under File Location in the GroupWise client is valid. See 
“Archiving the Items in Your Mailbox” in “Managing Your Mailbox” in the GroupWise 6.5 
Windows Client User Guide or “Archiving the Items in Your Mailbox” in “Managing Your 
Mailbox” in the GroupWise 6.5 Cross-Platform Client User Guide. 


The user’s archive is damaged. 


The Group Wise client automatically fixes most problems it detects with archive databases each 
time it starts. In addition, you can run GWCheck to fix more difficult problems the client can't 
handle. See “Group Wise Check (GWCheck)” in “Standalone Database Maintenance Programs” in 
the GroupWise 6.5 Administration Guide. 


Wrong Date/Time Appears in Messages 


Problem: 


Possible Cause: 


The wrong date or time or both appear in GroupWise messages. 


The time zone and daylight saving time information for the user’s post office and/or domain are 
incorrect. 
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Action: 


Possible Cause: 
Action: 
Possible Cause: 


Action: 


Use ConsoleOne to check the Domain and Post Office objects to make sure the time zone and 
daylight saving time settings are correct. See “Time Zones” in “System” in the GroupWise 6.5 
Administration Guide. 


The local time on the user’s workstation is incorrect. 
Check the local time on the user's workstation. 
The local time of the servers where the GroupWise agents are running is incorrect. 


Check the local time of the server where the Group Wise agents are running. 


Status Isn't Being Returned for Sent Messages 


Problem: 


Possible Cause: 


Action: 


Possible Cause: 


Action: 


The user is unable to determine if recipients have received messages because no status information 
appears in the user's mailbox. 


The user has turned off status tracking. 


Ensure that the user's Group Wise client is configured to track status information. See “Confirming 
Delivery of Items You've Sent” in “Working with Items in Your Mailbox” in the GroupWise 6.5 
Windows Client User Guide or “Confirming Delivery of Items You've Sent” in “Working with 
Items in Your Mailbox” in GroupWise 6.5 Cross-Platform Client User Guide. 


Status information has been turned off for a gateway through which messages must pass. 


Check the status level set for the gateway. In ConsoleOne, click the Gateway object > Optional 
Gateway Settings > check the selected Outbound Status Level setting. 


User's Message Isn't Delivered 


Problem: 
Possible Cause: 


Action: 


Possible Cause: 
Action: 


Action: 


The user sends a GroupWise message, but one or more recipients do not receive it. 
The user elected to delay delivery. 


Ensure that the user does not have Delay Delivery selected in the GroupWise Windows client. See 
“Delaying Delivery of an Item” in “Customizing GroupWise” in the GroupWise 6.5 Windows 
Client User Guide. 


Message transfer has been interrupted at some point between sender and recipients. 
Check the user's mailbox for status information. 


For additional strategies, see “Strategies for Message Delivery Problems” on page 57. 


Users Don't Appear in the Address Book or Appear Multiple Times 


Problem: 
Possible Cause: 


Action: 


Possible Cause: 


Action: 


Valid GroupWise users are missing from the Address Book or are listed more than once. 
The user’s visibility has been set so the user is not visible to other users even though the user exists. 


Use ConsoleOne to check the users’ visibility. See “Controlling Object Visibility in the Address 
Book” in “Address Book” in the GroupWise 6.5 Administration Guide. 


User information in the local post office is not synchronized with the rest of the GroupWise 
system. 


Use ConsoleOne to synchronize the users' information. See “Synchronizing Individual Users or 
Resources” in “Databases” in the GroupWise 6.5 Administration Guide. 
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Screen Information Isn't Being Updated Immediately 


Problem: 


Action: 


The user performs an action in the GroupWise client but does not see the results of that action. For 
example, the user sends a message but does not see that message in the mailbox. Or the user deletes 
sent messages from the mailbox but the messages are still displayed. 


By default, the GroupWise Windows client updates the screen once every minute. Users can 
specify a shorter update interval in the client so their screen information is updated more 
frequently; this will also increase network traffic because the client will be polling the users' 
mailboxes more often. In the Group Wise Windows client, click Tools > Options, then double-click 
Environment. Click General, then adjust the Refresh Interval setting. 


User Is Notified of a New Message But the Message Isn't Received 


Problem: 


Possible Cause: 
Action: 
Possible Cause: 


Action: 


Possible Cause: 


Action: 


A Windows user receives notification a new Group Wise message has arrived but the message does 
not appear in the user's mailbox. 


The message might have been retracted by the sender before the recipient could open it. 
None. 
The message might have had a rule or filter applied to it. 


Have the user check for unwanted rules or filters in the GroupWise Windows client. See “Creating 
Rules” and “Filtering Items” in “Managing Your Mailbox” in the GroupWise 6.5 Windows Client 
User Guide. 


Message transfer has been interrupted at some point between sender and recipients. 


For additional strategies, see “Strategies for Message Delivery Problems” on page 57. 


User Experiences a Delay When Starting the Client or Using Certain Client Features 


Problem: 


Possible Cause: 


Action: 


The client user connects to the post office in client/server mode. DNS names have been configured 
on the system. The client user experiences a lengthy delay when performing one of the following 
activities: 


¢ Starting the GroupWise client 
+ Accessing a shared folder for the first time 
+ Accessing a query folder where sources are located in a different post office 
+ Using Find where sources are located in a different post office 
+ Accessing the Address Book for the first time 
+ Performing a cross-post office proxy 
The DNS search order for the user’s workstation includes unavailable DNS servers. 


Make sure the client workstation has the DNS search order set up correctly. The features listed 
above often require IP address information. If your system is configured with DNS names, these 
must be resolved to IP addresses by the client as these features are used. For each unavailable DNS 
server (IP address) that precedes an available DNS server in the configured search order, the client 
will experience a delay while timing out waiting to resolve DNS names. 
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User Experiences a Delay When Viewing or Printing 


Problem: A user experiences a lengthy delay when performing one of the following activities in the 
Group Wise client: 


+ Viewing an attachment 
+ Viewing a document 
+ Viewing mailbox items using QuickViewer 
+ Viewing item properties 
¢ Printing items or attachments 
Possible Cause: The user does not have a default printer set up. 


Action: Make sure the user has a valid default printer defined. Printer information is used for viewing as 
well as printing. 
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GroupWise Remote Problems 


+ “Remote Windows Client Error Messages” in GroupWise 6.5 Troubleshooting 1: Error 
Messages 


+ “User Cannot Connect to the Master GroupWise System” on page 97 
+ “Remote Message Flow Is Blocked” on page 97 
+ “Remote Mailbox Is Damaged” on page 97 


User Cannot Connect to the Master GroupWise System 
Problem: You cannot establish a connection from GroupWise” Remote to your master GroupWise system. 


Action: | Use the Remote Connection Log to display connection information and to troubleshoot connection 
problems. This log includes information about connection time, error messages, and so forth. 


Group Wise uses three files to log the connection information. These files are remote] .log, 
remote2.log, and remote3.log. GroupWise uses the next log file each time you run Group Wise 
Remote against your Remote mailbox. 


If you want to save the transmission information, select the information you want to save, right- 
click the connection log, then click Copy. You can save this information in a text file. 


Remote Message Flow Is Blocked 
Problem: Messages are not being transferred to/from GroupWise Remote. 


Action: To see how a message should travel to and from GroupWise Remote, see “Message Delivery to 
and from Group Wise Remote” in GroupWise 6.5 Troubleshooting 3: Message Flow and Directory 
Structure. 


Remote Mailbox Ils Damaged 
Problem: GroupWise Remote is not functioning correctly because it cannot access its Remote mailbox. 


Action: Verify that the structure of the Remote mailbox is correct. See “Remote Mailbox Directory” in 
GroupWise 6.5 Troubleshooting 3: Message Flow and Directory Structure. 


Action: Repair the Remote mailbox. See “GroupWise Check (GWCheck)” in “Standalone Database 
Maintenance Programs” in the GroupWise 6.5 Administration Guide. 
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Documentation Updates 


This section lists updates to Troubleshooting 2: Solutions to Common Problems that have been 
made since the initial release of GroupWise” 6.5. The information will help you to keep current 
on documentation updates and, in some cases, software updates (such as a Support Pack release). 


The information is grouped according to the date when Troubleshooting 2: Solutions to Common 
Problems was republished. Within each dated section, the updates are listed by the names of the 
main table of contents sections. 


Troubleshooting 2: Solutions to Common Problems has been updated on the following dates: 
+ “September 30, 2004” on page 99 
+ “August 23, 2004 (GroupWise 6.5 for Linux)” on page 99 
+ “July 16, 2003 (SP1)” on page 100 


September 30, 2004 


Location Change 


GroupWise Administrator 
Snap-In to ConsoleOne 
Problems 


“ConsoleOne Can't Access Added a solution for a locked domain database. 
the Domain Database” on 
page 81 


August 23, 2004 (GroupWise 6.5 for Linux) 


Location Change 


General Troubleshooting 
Strategies 


“Useful Linux Commands for Added a list of Linux commands to help the GroupWise administrator 
Administering a GroupWise who is new to Linux. 
System” on page 17 


GroupWise Administrator 


Snap-In to ConsoleOne 
Problems 


Documentation Updates 99 


Location Change 


“GroupWise Administrator Clarified that, on Linux, you must manually authenticate to eDirectory 
Snap-In to ConsoleOne and manually connect to a domain database. 
Problems” on page 81 


“You Can't Move a User” on Added reference to the User Move Status utility. 


page 83 

Strategies for Client 

Problems 

“GroupWise Client Identified where the same troubleshooting strategies can be used for 
Problems” on page 91 the Cross-Platform client and the Windows client. 


July 16, 2003 (SP1) 


Location Change 


Strategies for Agent 
Problems 


“POA Fails to Update the Steps were provided to resolve a common POA update problem. 
Post Office Database 
Version” on page 28 


“MTA Fails to Update the Steps were provided to resolve a common MTA update problem. 
Domain Database Version” 
on page 35 
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